StgOpenPropStg 関数 (coml2api.h)

[アーティクル]
08/22/2023

StgOpenPropStg 関数は、指定されたストレージオブジェクトまたはストリームオブジェクトで指定されたプロパティセットを開きます。プロパティセットは、 IPropertyStorage インターフェイスのシステム提供のスタンドアロン実装を提供します。

構文

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

パラメーター

[in] pUnk

要求されたプロパティセットオブジェクトを含むストレージオブジェクトまたはストリームオブジェクト上の IUnknown インターフェイスのインターフェイスポインター。

[in] fmtid

開くプロパティセットの FMTID。

[in] grfFlags

PROPSETFLAG 定数の値。

[in] dwReserved

今後使用するために予約されています。0 にする必要があります。

[out] ppPropStg

要求されたプロパティセットへのインターフェイスポインターを受け取る IPropertyStorage* ポインター変数へのポインター。

戻り値

この関数は、次に加えて、E_INVALIDARGおよびE_UNEXPECTEDの標準戻り値をサポートします。

注釈

StgOpenPropStg は、要求されたプロパティセットを開き、 IPropertyStorage インターフェイスのシステム提供のスタンドアロン実装を提供します。要求されたプロパティセットは、 pUnk で指定されたストレージオブジェクトまたはストリームオブジェクトに含まれています。 grfFlags パラメーターの値は、pUnk がストレージオブジェクトまたはストリームオブジェクトを指定するかどうかを示します。たとえば、PROPSETFLAG_NONSIMPLEが設定されている場合、 pUnk はストレージオブジェクトの IStorage インターフェイスに対してクエリを実行できます。

どちらの場合も、この関数は、プロパティセットを含むストレージオブジェクトまたはストリームオブジェクトに対して pUnk-AddRef> を呼び出します。呼び出し元は、不要になったらオブジェクトを解放する必要があります。

この関数は、 IPropertySetStorage::Open メソッドに似ています。ただし、StgOpenPropStg は、grfFlags パラメーターのPROPSETFLAG_UNBUFFERED値を含め、pUnk パラメーターと grfFlags パラメーターを追加します。 IPropertySetStorage インターフェイスをサポートしない IStorage インターフェイスがある場合、または PROPSETFLAG_UNBUFFERED 値を使用する場合は、Open メソッドの代わりにこの関数を使用します。 PROPSETFLAG_UNBUFFEREDの使用方法の詳細については、「 PROPSETFLAG 定数」を参照してください。

grfFlags パラメーターは、PROPSETFLAG 定数から取得された値の組み合わせです。新しい列挙値PROPSETFLAG_UNBUFFEREDがサポートされています。詳細については、「 PROPSETFLAG 定数」を参照してください。

この関数は再頒布可能な iprop.dll からエクスポートされます。これは、Service Pack 2 (SP2) を使用してWindows NT 4.0 に含まれ、Windows 95 以降では再頒布可能パッケージとして使用できます。 Windows 2000 では、Ole32.dll からエクスポートされます。 Windows 2000 では iprop.dll からエクスポートすることもできますが、呼び出しは ole32.dll に転送されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	coml2api.h (Propidl.h を含む)
Library	Ole32.lib
[DLL]	Ole32.dll