IDiscRecorder2::get_LegacyDeviceNumber method (imapi2.h)

Retrieves the legacy device number for a CD or DVD device.

Syntax

HRESULT get_LegacyDeviceNumber(
  [out] LONG *legacyDeviceNumber
);

Parameters

[out] legacyDeviceNumber

Zero-based index number of the device, based on the order the device was installed on the computer.

This value can change during PNP activity when devices are added or removed from the computer, or across boot sessions and should not be considered a unique identifier for the device.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
E_POINTER
Pointer is not valid.

Value: 0x80004003

E_FAIL
Unspecified failure.

Value: 0x80004005

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IDiscRecorder2

IDiscRecorder2::get_VolumePathNames