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 を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
リターン コード | 説明 |
---|---|
|
ポインター pvValue は NULL です。 |
|
パラメーター cbValue は、プロパティ値の必要なサイズと一致しません。 |
|
メモリが不足しています。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | devicetopology.h |