IPortableDeviceValues::SetBufferValue メソッド

SetBufferValue メソッドは、新しい BYTE* 値を追加します (型VT_VECTOR |VT_UI1) または既存のものを上書きします。

構文

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

key [in]: 作成または上書きする項目を指定する REFPROPERTYKEY 。
pValue [in]: アイテムに書き込むデータを格納する BYTE* です。送信されたバッファーデータはインターフェイスにコピーされるため、呼び出し元はこの呼び出しを行った後にこのバッファーを解放できます。
cbValue [in]: pValue が指す値のサイズ (バイト単位)。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。

既存の値に key パラメーターで 指定されたキーが同じである場合、既存の値は警告なしで上書きされます。既存のキーメモリは適切に解放されます。

NULL または 0 サイズのバッファーの設定はサポートされていません。

要件	値
ヘッダー	PortableDeviceTypes.h
ライブラリ	PortableDeviceGUIDs.lib