Метод IDiscMaster2::get__NewEnum (imapi2.h)
Получает список устройств CD и DVD, установленных на компьютере.
Синтаксис
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Параметры
[out] ppunk
Интерфейс IEnumVariant , используемый для перечисления устройств CD и DVD, установленных на компьютере. Элементы перечисления — это варианты с типом VT_BSTR. Используйте член bstrVal для получения уникального идентификатора устройства.
Возвращаемое значение
S_OK возвращается, когда число запрошенных элементов (celt) возвращается успешно или количество возвращенных элементов (pceltFetched) меньше числа запрошенных элементов. Параметры celt и pceltFetched определяются IEnumVariant.
В результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
Недопустимый указатель.
Значение: 0x80004003 |
Комментарии
Перечисление представляет собой snapshot устройств на компьютере во время вызова и не отражает добавленные и удаленные устройства. Чтобы получать уведомления о добавлении или удалении устройства с компьютера, реализуйте интерфейс DDiscMaster2Events .
Чтобы получить один идентификатор, см. свойство IDiscMaster2::get_Item .
Идентификатор устройства гарантированно будет уникальным и статическим для данного устройства, распознаваемым Windows Plug and Play. Идентификатор можно использовать в качестве значения ключа для сохранения средства записи пользователя по умолчанию, а также для кэширования других статических сведений о конкретном устройстве (например, VendorID и ProductID) расширенным приложением.
Требования
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |