IPropertyStore::GetValue メソッド (propsys.h)

このメソッドは、特定のプロパティのデータを取得します。

構文

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

パラメーター

key

TBD

pv

メソッドが IPropertyStore::GetValue 正常に戻った後、このパラメーターは プロパティに関するデータを含む PROPVARIANT 構造体を指します。

戻り値

成功した場合はS_OKまたはINPLACE_S_TRUNCATED、それ以外の場合はエラー値を返します。

返された PROPVARIANT がより正規の形式に変換されたことを示すINPLACE_S_TRUNCATEDが返されます。 たとえば、これは文字列値から先頭または末尾のスペースをトリミングするために行われます。 SUCCEEDED マクロを使用して戻り値をチェックする必要があります。これにより、INPLACE_S_TRUNCATEDが成功コードとして扱われます。 SUCCEEDED マクロは Winerror.h ファイルで定義されています。

注釈

key で参照される PROPERTYKEY がプロパティ ストアに存在しない場合、このメソッドは S_OKを返し、pv によって指される構造体の vt メンバーが VT_EMPTY に設定されます。

要件

こちらもご覧ください

IPropertyStore

IPropertyStore::GetAt