次の方法で共有


ISensor::SetProperties メソッド (sensorsapi.h)

Important

代わりに UWP センサー API を 使用してください。

COM ベースの Sensor API は非推奨であり、新しいアプリケーションでは使用しないでください。 追加の機能や拡張機能は計画されておらず、サポートは制限されます。

センサーのプロパティを指定します。

構文

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

パラメーター

[in] pProperties

設定するプロパティと値の一覧を含む IPortableDeviceValues インターフェイスへのポインター。

[out] ppResults

正常に設定されたプロパティの一覧を受け取る IPortableDeviceValues インターフェイスのアドレス。 各プロパティには HRESULT 値が関連付けられています。この値は、プロパティの設定が成功したかどうかを示します。

戻り値

このメソッドは HRESULT を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。

リターン コード Description
S_OK
メソッドは成功しました。
S_FALSE
指定したプロパティの 1 つ以上を設定する要求が失敗しました。 ppResults を調べて、成功したプロパティ (存在する場合) を判断します。
E_POINTER
ppResults に対して NULL が渡されました。

注釈

このメソッドを使用すると、1 回の呼び出しで、センサーの作成、モデル、シリアル番号などの 1 つ以上のプロパティの値を指定できます。

すべてのプロパティを設定できるわけではありません。

IPortableDeviceValues は、Windows ポータブル デバイス API によって定義されます。

例示

プロパティを設定する方法の例については、「センサーのプロパティの 設定と取得」を参照してください。

Requirements

Requirement 価値
サポートされる最小クライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
ターゲット プラットフォーム ウィンドウズ
Header sensorsapi.h
Library Sensorsapi.lib
DLL Sensorsapi.dll

こちらも参照ください

GetProperties

ISensor