检索多个传感器属性。
Syntax
HRESULT GetProperties(
[in] IPortableDeviceKeyCollection *pKeys,
[out] IPortableDeviceValues **ppProperties
);
参数
[in] pKeys
指向 IPortableDeviceKeyCollection 接口的指针，该接口包含所请求的属性值的 PROPERTYKEY 集合。 设置为 NULL 以检索所有支持的属性。
[out] ppProperties
接收指向所请求属性值的指针的 IPortableDeviceValues 指针的地址。
返回值
该方法返回 HRESULT。 可能的值包括但不限于下表中的值。
| 返回代码 | Description |
|---|---|
|
方法成功。 |
|
传感器驱动程序不支持至少一个指定的属性。 通过 IPortableDeviceValues 接口返回的每个不受支持的属性 PROPVARIANT 都将其错误值设置为HRESULT_FROM_WIN32（ERROR_NOT_FOUND）。 |
|
为 ppProperties 传入 NULL。 |
注解
通过此方法，可以通过进行单个调用来检索多个属性的值，例如传感器生成、模型和序列号。 若要检索单个属性，请调用 ISensor：：GetProperty。
IPortableDeviceKeyCollection 和 IPortableDeviceValues 接口由 Windows 可移植设备 API 定义。
例子
有关如何从传感器检索属性的示例，请参阅 “设置和检索传感器属性”。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 7 [仅限桌面应用] |
| 支持的最低服务器 | 无受支持的版本 |
| 目标平台 | Windows操作系统 |
| Header | sensorsapi.h |
| Library | Sensorsapi.lib |
| DLL | Sensorsapi.dll |