IPortableDeviceValues::GetBufferValue メソッド

GetBufferValue メソッドはバイト配列値を取得します (型VT_VECTOR |VT_UI1) キーで指定します。

構文

HRESULT GetBufferValue(
  [in]  REFPROPERTYKEY key,
  [out] BYTE           **ppValue,
  [out] DWORD          *pcbValue
);

key [in]: 取得する項目を指定する REFPROPERTYKEY キー。
ppValue [out]: 取得した BYTE* 値へのポインター。呼び出し元は、 CoTaskMemFree を呼び出してメモリを解放する役割を担います。
pcbValue [out]: ppValue のサイズへのポインター (バイト単位)。

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

リターンコード	説明
S_OK	メソッドが成功しました。
DISP_E_TYPEMISMATCH	key で指定されたプロパティは BYTE* 型ではありません。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	key で指定されたプロパティがコレクション内にありません。

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

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