Метод ISensor::GetProperties (sensorsapi.h)

Статья
03/01/2024

Извлекает несколько свойств датчика.

Синтаксис

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Параметры

[in] pKeys

Указатель на интерфейс IPortableDeviceKeyCollection , содержащий коллекцию PROPERTYKEY для запрашиваемых значений свойств. Присвойте значение NULL , чтобы получить все поддерживаемые свойства.

[out] ppProperties

Адрес указателя IPortableDeviceValues , который получает указатель на запрошенные значения свойств.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Драйвер датчика не поддерживает хотя бы одно из указанных свойств. Для каждого неподдерживаемого свойства PROPVARIANT, возвращаемого через интерфейс IPortableDeviceValues, будет задано значение HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	Для ppProperties было передано значение NULL.

Этот метод позволяет получить значения нескольких свойств, таких как элемент датчика, модель и серийный номер, путем выполнения одного вызова. Чтобы получить одно свойство, вызовите метод ISensor::GetProperty.

Интерфейсы IPortableDeviceKeyCollection и IPortableDeviceValues определяются API переносимых устройств Windows.

Примеры

Пример извлечения свойств с датчика см. в разделе Настройка и получение свойств датчика.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	sensorsapi.h
Библиотека	Sensorsapi.lib
DLL	Sensorsapi.dll

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

ISensor

Свойства датчика

SetProperties

Поделиться через