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


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

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

Синтаксис

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