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	传感器驱动程序不支持至少一个指定的属性。通过 IPortableDeviceValues 接口返回的每个不受支持的属性 PROPVARIANT 都将将其错误值设置为 HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 。
E_POINTER	为 ppProperties 传入 NULL。

使用此方法，可以通过进行单个调用来检索多个属性的值，例如传感器制造、型号和序列号。若要检索单个属性，请调用 ISensor：：GetProperty。

IPortableDeviceKeyCollection 和 IPortableDeviceValues 接口由 Windows 可移植设备 API 定义。

有关如何从传感器检索属性的示例，请参阅设置和检索传感器属性。