ISensor::SetProperties 方法 (sensorsapi.h)

指定传感器属性。

语法

HRESULT SetProperties(
  [in]  IPortableDeviceValues *pProperties,
  [out] IPortableDeviceValues **ppResults
);

参数

[in] pProperties

指向 IPortableDeviceValues 接口的 指针,其中包含要设置的属性和值的列表。

[out] ppResults

接收成功设置的属性列表的 IPortableDeviceValues 接口的地址。 每个属性都有一个关联的 HRESULT 值,该值指示设置属性是否成功。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
S_FALSE
设置一个或多个指定属性的请求失败。 检查 ppResults 以确定哪些属性(如果有)成功。
E_POINTER
已为 ppResults 传入 NULL。

注解

使用此方法,可以通过进行单个调用来指定一个或多个属性(例如传感器制造、型号和序列号)的值。

并非所有属性都可以设置。

IPortableDeviceValues 由 Windows 可移植设备 API 定义。

示例

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

要求

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

另请参阅

GetProperties

ISensor