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 定义。

示例

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

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

另请参阅

ISensor

传感器属性

SetProperties