PSPropertyBag_ReadStream関数 (propsys.h)

指定したプロパティ バッグに含まれる特定のプロパティに格納されているデータ ストリームを読み取ります。

構文

PSSTDAPI PSPropertyBag_ReadStream(
  [in]  IPropertyBag *propBag,
  [in]  LPCWSTR      propName,
  [out] IStream      **value
);

パラメーター

[in] propBag

種類: IPropertyBag*

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

[in] propName

種類: LPCWSTR

null で終わるプロパティ名文字列へのポインター。

[out] value

種類: IStream**

この関数が正常に返されるときに IStream オブジェクトを受け取るポインターのアドレス。

戻り値

型: HRESULT

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

注釈

PSPropertyBag_ReadStream関数の呼び出し元は、この関数によって返される IStream オブジェクトに対して IUnknown::Release メソッドを呼び出す必要があります。

IPropertyBag と IPersistPropertyBag は、テキストとして保存機能を最適化します。 IPropertyBag と IPropertyBag2 は、オブジェクトにプロパティ バッグを提供します。このプロパティ バッグには、オブジェクトがプロパティを永続的に保存できます。 IPropertyBag2 を使用すると、オブジェクトは各プロパティの型情報を取得できます。 IPropertyBag2::Read により、プロパティ バッグから 1 つ以上のプロパティが読み取られ、 IPropertyBag2::Write によって 1 つ以上のプロパティがプロパティ バッグに保存されます。

要件

こちらもご覧ください

PSPropertyBag_WriteStream