Метод 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.

В результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата	Описание
E_POINTER	Недопустимый указатель. Значение: 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

См. также раздел

IDiscMaster2

IDiscMaster2::get_Count