StgOpenPropStg 関数 (coml2api.h)

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 に転送されます。

要件

こちらもご覧ください

IPropertySetStorage

IPropertySetStorage-スタンドアロン実装

IPropertyStorage

IPropertyStorage-スタンドアロン実装

PROPSETFLAG 定数

StgCreatePropSetStg

StgCreatePropStg