IPortableDeviceValues::SetBufferValue メソッド (portabledevicetypes.h)

新しい BYTE* 値 (型VT_VECTORまたはVT_UI1) を追加するか、既存の値を上書きします。

構文

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

[in] key

作成または上書きする項目を指定する REFPROPERTYKEY 。

[in] pValue

アイテムに書き込むデータを含む BYTE へのポインター。送信されたバッファーデータがインターフェイスにコピーされるため、呼び出し元はこの呼び出しを行った後にこのバッファーを解放できます。

[in] cbValue

pValue が指す値のサイズ (バイト単位)。

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

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

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

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

要件	値
対象プラットフォーム	Windows
ヘッダー	portabledevicetypes.h