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