StarBurn.h

Execution status. EN_SUCCESS if initialization process completed successfuly.

This function initializes burning toolkit. It's expected to be called as the very first function call before calling any other StarBurn exported code. Some of StarBurn functions would work with not initialized core, some would fail with EN_REGISTRATION_FAILED error. Starting from build 4.2.6 it's *REQUIRED* to call this function, it does not matter what build (static Vs. dynamic) of StarBurn is used. The difference between this call and call to StarBurn_UpStart(...) is that this particular call assumes StarBurn key is being embedded to the application binary and StarBurn_UpStart(...) always looks for StarBurn.key near application executable.

See samples for details how and when call StarBurn_UpStartEx() and StarBurn_UpStart() functions.

See samples for details how and when call StarBurn_UpStart() and StarBurn_UpStartEx() functions.

This example checks for the toolkit version and initializes it. 

// Somewhere in the data region
ULONG l__ULONG__Version;
EXCEPTION_NUMBER l__EXCEPTION_NUMBER = EN_SUCCESS;
UCHAR l__UCHAR__RegistrationKey[ ] = { ... }; // Registration key goes here

// Get toolkit version
l__ULONG__Version =
StarBurn_GetVersion();

// Check for correct number
if ( l__ULONG__Version < SUPPORTED_VERSION_NUMBER )
{
// Handle error here...
}

// Try to initialize toolkit
l__EXCEPTION_NUMBER =
StarBurn_UpStartEx(
    ( PVOID )( &l__UCHAR__RegistrationKey ),
    sizeof( l__UCHAR__RegistrationKey )
    );

// Check for success
if ( l__EXCEPTION_NUMBER != EN_SUCCESS )
{
// Handle error here...
}

Functions