Метод IPortableDeviceProperties::GetValues (portabledeviceapi.h)

Статья
08/25/2023

Метод GetValues извлекает список указанных свойств из указанного объекта на устройстве.

Синтаксис

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Параметры

[in] pszObjectID

Указатель на строку, завершающуюся значением NULL, которая содержит идентификатор объекта для запроса. Чтобы указать устройство, используйте WPD_DEVICE_OBJECT_ID.

[in] pKeys

Указатель на интерфейс IPortableDeviceKeyCollection , содержащий одно или несколько свойств для запроса. Если значение равно NULL, будут извлечены все свойства. Список свойств, определенных переносными устройствами Windows, см. в разделе Свойства и атрибуты .

[out] ppValues

Адрес переменной, получающей указатель на интерфейс IPortableDeviceValues , содержащий запрошенные значения свойств. Они будут возвращены в виде пар PROPERTYKEY/value, где тип данных значения зависит от свойства . Если по какой-либо причине не удалось получить значение, возвращаемый тип будет VT_ERROR и содержать значение HRESULT, описывающее ошибку извлечения. Вызывающий объект должен освободить этот интерфейс после завершения работы с ним.

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

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

Код возврата	Описание
S_OK	Были извлечены все запрошенные значения свойств.
S_FALSE	Не удалось получить одно или несколько значений свойств. Свойства проблемы будут иметь значение HRESULT в полученном параметре ppValues .