IDiscMaster2::get__NewEnum method (imapi2.h)
Retrieves a list of the CD and DVD devices installed on the computer.
Syntax
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Parameters
[out] ppunk
An IEnumVariant interface that you use to enumerate the CD and DVD devices installed on the computer. The items of the enumeration are variants whose type is VT_BSTR. Use the bstrVal member to retrieve the unique identifier of the device.
Return value
S_OK is returned when the number of requested elements (celt) are returned successfully or the number of returned items (pceltFetched) is less than the number of requested elements. The celt and pceltFetched parameters are defined by IEnumVariant.
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 |
|---|---|
|
Pointer is not valid.
Value: 0x80004003 |
Remarks
The enumeration is a snapshot of the devices on the computer at the time of the call and will not reflect devices that are added and removed. To receive notification when a device is added or removed from the computer, implement the DDiscMaster2Events interface.
To retrieve a single identifier, see the IDiscMaster2::get_Item property.
The device identifier is guaranteed to be unique and static for a given device as recognized by Windows Plug and Play. You can use the identifier as a key value for saving the user's default burner, and can also be used to cache other device-specific static information (for example, VendorID and ProductID) by an advanced application.
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 |