PSPropertyBag_ReadStr関数 (propsys.h)

プロパティ バッグ内のプロパティの文字列データ値を読み取ります。

構文

PSSTDAPI PSPropertyBag_ReadStr(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] LPWSTR       value,
  [out] int          characterCount
);

パラメーター

[in] propBag

種類: IPropertyBag*

プロパティが格納されているプロパティ バッグを表す IPropertyBag オブジェクトへのポインター。

[in] propName

種類: LPCWSTR

null で終わるプロパティ名の文字列。

[out] value

種類: LPCWSTR

この関数が戻るとき、 には文字列プロパティ値へのポインターが含まれます。

[out] characterCount

型: int

この関数は、返される 値 パラメーターのサイズ (最大文字数) を表す整数を返します。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

プロパティ バッグプロパティ関数 API は、ウィンドウ型と、プロパティ バッグ内の値を表すために使用される VARIANT 型の間で変換します。 これにより、プロパティ バッグの使用が容易になり、アプリケーションが簡素化され、一般的なコーディング エラーが回避されます。

要件

こちらもご覧ください

PSPropertyBag_WriteStr