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
[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 |