IDeviceSpecificProperty::SetValue メソッド (devicetopology.h)

  • [アーティクル]

SetValue メソッドは、デバイス固有のプロパティの値を設定します。

構文

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] pvValue

デバイス固有のプロパティの新しい値へのポインター。

[in] cbValue

デバイス固有のプロパティ値のサイズ (バイト単位)。

[in] pguidEventContext

IControlChangeNotify::OnNotify メソッドのコンテキスト値。 このパラメーターは、イベント コンテキスト GUID を指します。 SetValue 呼び出しによってコントロールの状態が変更された場合、そのコントロールに IControlChangeNotify インターフェイスを登録しているすべてのクライアントが通知を受け取ります。 OnNotify メソッドの実装では、クライアントはイベント コンテキスト GUID を調べて、その GUID または別のクライアントがコントロール変更イベントのソースであるかどうかを検出できます。 呼び出し元がこのパラメーターに NULL ポインターを指定した場合、クライアントの通知メソッドは NULL コンテキスト ポインターを受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
E_POINTER
 ポインター pvValue は NULL です。
E_INVALIDARG
 パラメーター cbValue は、プロパティ値の必要なサイズと一致しません。
E_OUTOFMEMORY
 メモリが不足しています。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IDeviceSpecificProperty インターフェイス