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. License file StarBurn.key is assumed to be located near main application executable. 

ATTENTION! This call is OBSOLTE. Use StarBurn_UpStartEx(...) instead of it.

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

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

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;

// 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_UpStart();

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

Functions