ILTDVDBurner::GetDriveId

Summary

Retrieves the ID that uniquely identifies the drive in the system.

Syntax

Parameters

ILTDVDBurner *pDVDBurner

Pointer to an ILTDVDBurner interface.

long Index

Value that represents a zero-based index of the drive for which to retrieve the ID.

BSTR *pVal

Pointer to a character string to be updated with the drive ID.

Returns

Comments

Save the retrieved ID for later use: it is guaranteed to be unique and not to change.

If the function succeeds, the user is responsible for freeing the retrieved ID string by calling SysFreeString.

Required DLLs and Libraries

• LTDVDBrn
• DSKernel (Multimedia toolkits) or LTKRN (Imaging, Document, or Medical toolkits)
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files to be Included with your Application.

Platforms

Win32, x64

See Also

Functions

• ILTDVDBurner::get_DriveCount

Topics

• Functions
• How to use the DVD Burner to Burn ISO Files and DVD Images

Example

For a C example, refer to ILTDVDBurner::GetDriveId Example for C.

For a C++ example, refer to ILTDVDBurner::GetDriveId Example for C++.