IPortableDeviceValues::GetValue メソッド

GetValue メソッドは、キーで指定された PROPVARIANT 値を取得します。

構文

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

パラメーター

key [in]

取得する項目を指定する REFPROPERTYKEY キー。

pValue [out]

取得した PROPVARIANT 値へのポインター。 呼び出し元は、その操作が完了したら PropVariantClear を呼び出してメモリを解放する必要があります。

戻り値

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

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

解説

pValue の VARTYPE がVT_VECTORまたはVT_UI1の場合、NULL または 0 サイズのバッファーの取得はサポートされていません。 たとえば、pValue.caub.pElems = NULL も pValue.caub.cElems = 0 も使用できません。

このメソッドを使用して、コレクションから任意の型の値を取得できます。 ただし、値の型が事前にわかっている場合は、PROPVARIANT 値を直接操作するオーバーヘッドを回避するために、このインターフェイスの特殊な取得方法の 1 つを使用します。

必要条件

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

関連項目

IPortableDeviceValues インターフェイス

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue