ISensor::SetProperties 方法(sensorsapi.h)

重要

请改用 UWP 传感器 API

基于 COM 的传感器 API 已弃用,不应在新应用程序中使用。 没有计划其他功能或增强功能,并且支持将受到限制。

指定传感器属性。

Syntax

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

参数

[in] pProperties

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

[out] ppResults

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

返回值

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

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

注解

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

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

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

例子

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

要求

Requirement 价值
最低支持的客户端 Windows 7 [仅限桌面应用]
支持的最低服务器 无受支持的版本
目标平台 Windows操作系统
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

另请参阅

GetProperties

ISensor