Метод IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Статья
08/25/2023

Метод GetFunctionalObjects извлекает все функциональные объекты, соответствующие указанной категории на устройстве.

Синтаксис

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Параметры

[in] Category

REFGUID, указывающий категорию для поиска. Это можно WPD_FUNCTIONAL_CATEGORY_ALL, чтобы вернуть все функциональные объекты.

[out] ppObjectIDs

Адрес переменной, получающей указатель на интерфейс IPortableDevicePropVariantCollection , содержащий идентификаторы объектов функциональных объектов в виде строк (тип VT_LPWSTR в извлеченных элементах PROPVARIANT ). Если объекты запрошенного типа не найдены, это будет пустая коллекция (не NULL). Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.

Обычно эта операция выполняется быстро, так как драйверу не требуется выполнять полное перечисление содержимого, а количество полученных функциональных объектов обычно меньше 10. Если объекты запрошенного типа не найдены, этот метод не возвращает ошибку, а возвращает пустую коллекцию для ppObjectIDs.