Library Class Reference

Initializes PrimoBurner and manages license information. More...

Static Public Member Functions
static void	DisableTraceLog ()
	Disables the PrimoBurner trace log.
static bool	EnableTraceLog ()
	Enables the PrimoBurner trace log.
static bool	EnableTraceLog (string logFile)
	Enables the PrimoBurner trace log.
static bool	EnableTraceLog (String logFile, bool useExistingFile)
	Enables the PrimoBurner trace log.
static Int32	GetCDROMIndexFromLetter (char driveLetter)
	Gets the DeviceEnumerator index of a device from its drive letter.
static Char	GetCDROMLetterFromIndex (Int32 driveIndex)
	Gets the drive letter of a device from its DeviceEnumerator index.
static void	Initialize ()
	Initializes the managed code library.
static bool	IsLicensed (string product, string feature)
	Checks whether a product feature is licensed.
static LicenseStatusFlags	SetLicense (string license)
	Sets a license string.
static void	Shutdown ()
	This method must be called to cleanup the managed resources.

Properties
static LicenseStatusFlags	LicenseStatus [get]
	Returns the current license status.

Detailed Description

Initializes PrimoBurner and manages license information.

Member Function Documentation

EnableTraceLog() [1/3]

static bool EnableTraceLog ( )

static

Enables the PrimoBurner trace log.

The trace log is useful for identifying errors or problems with particular devices.

The method creates a file named "PrimoBurner.log" in the user's home directory. If the file already exists the method will overwrite it.

Version

4.0.1

Returns

true - Success.

false - If a log file cannot be created with the specified path.

References Library.EnableTraceLog().

Referenced by Library.EnableTraceLog(), and Library.EnableTraceLog().

EnableTraceLog() [2/3]

static bool EnableTraceLog ( string  logFile )

static

Enables the PrimoBurner trace log.

The trace log is useful for identifying errors or problems with particular devices.

Parameters

logFile

Full path to the file that should be used to log PrimoBurner trace messages.

If the file already exists the method will overwrite it.

Returns

true - Success.

false - If a log file cannot be created with the specified path.

References Library.EnableTraceLog().

EnableTraceLog() [3/3]

static bool EnableTraceLog ( String  logFile, bool  useExistingFile  )

static

Enables the PrimoBurner trace log.

The trace log is useful for identifying errors or problems with particular devices.

Parameters

logFile	Full path to the file that should be used to log PrimoBurner trace messages.
useExistingFile	Indicates whether an existing file should be used or a new log file should be created. Set this parameter to false to create a new empty log file or to true to use a file that already exists. The default value of this parameter is "false".

Returns

true - Success.

false - If a log file cannot be created with the specified path.

References PrimoSoftware.Burner.Format.

GetCDROMIndexFromLetter()

static Int32 GetCDROMIndexFromLetter ( char  driveLetter )

static

Gets the DeviceEnumerator index of a device from its drive letter.

Parameters

driveLetter

The drive letter of the device.

Returns

The DeviceEnumerator index of the device.

See also

DeviceEnumerator

GetCDROMLetterFromIndex()

static Char GetCDROMLetterFromIndex ( Int32  driveIndex )

static

Gets the drive letter of a device from its DeviceEnumerator index.

Parameters

driveIndex

The index of the device in DeviceEnumerator

Returns

The drive letter of the device.

///

See also

DeviceEnumerator

Initialize()

static void Initialize ( )

static

Initializes the managed code library.

This method must be called before using any other method or object from this library.

IsLicensed()

static bool IsLicensed ( string  product, string  feature  )

static

Checks whether a product feature is licensed.

Parameters

product	The product id. If null the PrimoBurner product is implied.
feature	The feature id. If null> the default PrimoBurner product feature is implied.

Returns

If true the specified product feature is licensed.

SetLicense()

static LicenseStatusFlags SetLicense ( string  license )

static

Sets a license string.

Parameters

license

A string with license information. It is allowed to set NULL in which case the license is cleared.

Returns

The current license status after the license is set.

Until the current license is resolved SetLcense will reject any license string and will return false.

To obtain a license please contact PrimoBurner SDK Sales at sales.nosp@m.@pri.nosp@m.mobur.nosp@m.ner..nosp@m.com.

See also

Library.LicenseStatus

Property Documentation

LicenseStatus

LicenseStatusFlags LicenseStatus

staticget

Returns the current license status.