IPropertyStore_GetValue

特定のプロパティのデータを取得する。

IPropertyStore_GetValue this, key, pv

this : [comobj] IPropertyStore インターフェースの COM オブジェクト変数
key : [var] TBD
pv : [int] IPropertyStore::GetValue メソッドが正常に戻った後、このパラメーターはプロパティに関するデータを含む PROPVARIANT 構造体を指す。

(プラグイン / モジュール : com_misc.dll)

解説

特定のプロパティのデータを取得する。

[戻り値]
成功した場合は S_OK または INPLACE_S_TRUNCATED
を返す。そうでなければエラー値を返す。INPLACE_S_TRUNCATED は返された PROPVARIANT
がより正準な形式に変換されたことを示す。例えば文字列値の前後の空白をトリミングした場合などである。戻り値を確認するには
INPLACE_S_TRUNCATED を成功コードとして扱う SUCCEEDED マクロを使用しなければならない。SUCCEEDED
マクロは Winerror.h で定義されている。

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

情報