共用方式為


ISensor::SetProperties 方法 (sensorsapi.h)

這很重要

請改用 UWP 感應器 API

COM 型感測器 API 已被取代,不應該用於新的應用程式。 沒有計劃提供其他功能或增強功能,並且支援將受到限制。

指定感應器屬性。

語法

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 [僅限桌面應用程式]
支援的最低伺服器 不支援
目標平臺 窗戶
Header 傳感器API.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

另請參閱

取得屬性

ISensor