指定感應器屬性。
語法
HRESULT SetProperties(
[in] IPortableDeviceValues *pProperties,
[out] IPortableDeviceValues **ppResults
);
參數
[in] pProperties
IPortableDeviceValues 介面的指標,其中包含要設定的屬性和值清單。
[out] ppResults
IPortableDeviceValues 介面的位址,可接收成功設定的屬性清單。 每個屬性都有相關聯的 HRESULT 值,指出設定屬性是否成功。
返回值
這個方法會傳回 HRESULT。 可能的值包括但不限於下表中的值。
| 回傳碼 | Description |
|---|---|
|
方法成功了。 |
|
設定一或多個指定內容的要求失敗。 檢查 ppResults 以判斷哪些屬性 (如果有的話) 成功。 |
|
已針對 ppResults 傳入 NULL。 |
備註
此方法可讓您透過進行單一呼叫來指定一或多個屬性的值,例如感測器品牌、型號和序號。
並非所有屬性都可以設定。
IPortableDeviceValues 是由 Windows 可攜式裝置 API 所定義。
範例
如需如何設定屬性的範例,請參閱 設定和擷取感應器屬性。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限桌面應用程式] |
| 支援的最低伺服器 | 不支援 |
| 目標平臺 | 窗戶 |
| Header | 傳感器API.h |
| Library | Sensorsapi.lib |
| DLL | Sensorsapi.dll |