センサーのプロパティを指定します。
構文
HRESULT SetProperties(
[in] IPortableDeviceValues *pProperties,
[out] IPortableDeviceValues **ppResults
);
パラメーター
[in] pProperties
設定するプロパティと値の一覧を含む IPortableDeviceValues インターフェイスへのポインター。
[out] ppResults
正常に設定されたプロパティの一覧を受け取る IPortableDeviceValues インターフェイスのアドレス。 各プロパティには、プロパティの設定が成功したかどうかを示す HRESULT 値が関連付けられています。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
指定したプロパティの 1 つ以上を設定する要求が失敗しました。 ppResults を調べて、成功したプロパティ (存在する場合) を確認します。 |
|
ppResults に対して NULL が渡されました。 |
注釈
このメソッドを使用すると、1 回の呼び出しを行うことで、センサーの作成、モデル、シリアル番号などの 1 つ以上のプロパティの値を指定できます。
すべてのプロパティを設定できるわけではありません。
IPortableDeviceValues は、Windows ポータブル デバイス API によって定義されます。
例
プロパティを設定する方法の例については、「センサープロパティの 設定と取得」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | sensorsapi.h |
| Library | Sensorsapi.lib |
| [DLL] | Sensorsapi.dll |