StgCreatePropStg 関数は、指定されたストレージまたはストリーム オブジェクトにプロパティ セットを作成して開きます。 プロパティ セットは、 IPropertyStorage インターフェイスのシステム提供のスタンドアロン実装を提供します。
構文
HRESULT StgCreatePropStg(
[in] IUnknown *pUnk,
[in] REFFMTID fmtid,
[in] const CLSID *pclsid,
[in] DWORD grfFlags,
[in] DWORD dwReserved,
[out] IPropertyStorage **ppPropStg
);
パラメーター
[in] pUnk
新しいプロパティ セットを格納するストレージまたはストリーム オブジェクトの IUnknown インターフェイスへのポインター。
[in] fmtid
作成するプロパティ セットの FMTID。
[in] pclsid
このプロパティ セットの最初の CLSID へのポインター。 NULL を指定できます。この場合、pclsid はすべてのゼロに設定されます。
[in] grfFlags
プロパティ セットの作成方法と開き方を決定する PROPSETFLAG 定数 の値。
[in] dwReserved
予約;は 0 である必要があります。
[out] ppPropStg
新しいプロパティ セットへのインターフェイス ポインターを受け取る IPropertyStorage* ポインター変数のアドレス。
戻り値
この関数は、次に加えて、E_INVALIDARGおよびE_UNEXPECTEDの標準戻り値をサポートします。
注釈
StgCreatePropStg は、 IPropertyStorage インターフェイスのシステム提供のスタンドアロン実装を提供する新しいプロパティ セットを作成して開きます。 新しいプロパティ セットは、 pUnk で指定されたストレージ オブジェクトまたはストリーム オブジェクトに含まれています。 grfFlags パラメーターの値は、pUnk がストレージ オブジェクトまたはストリーム オブジェクトを指定するかどうかを示します。 たとえば、PROPSETFLAG_NONSIMPLEが設定されている場合、 pUnk はストレージ オブジェクトの IStorage インターフェイスに対してクエリを実行できます。
どちらの場合も、この関数は、プロパティ セットを含むストレージ オブジェクトまたはストリーム オブジェクトに対して pUnk-AddRef> を呼び出します。 オブジェクトが不要になった場合は、呼び出し元がオブジェクトを解放する必要があります。
この関数は、 IPropertySetStorage::Create メソッドに似ています。 ただし、 StgCreatePropStg は pUnk パラメーターを追加し、 grfFlags パラメーターのPROPSETFLAG_UNBUFFERED値をサポートします。 IPropertySetStorage インターフェイスをサポートしない IStorage インターフェイスがある場合、または PROPSETFLAG_UNBUFFERED 値を使用する場合は、Create メソッドの代わりにこの関数を使用します。 このPROPSETFLAG_UNBUFFERED列挙値の使用の詳細については、「 PROPSETFLAG 定数」を参照してください。
プロパティ セットには、コード ページとロケール識別子 (ID) プロパティが自動的に含まれます。 これらは、それぞれ現在のシステムの既定値と現在のユーザーの既定値に設定されます。
grfFlags パラメーターは、PROPSETFLAG 定数から取得された値の組み合わせです。 新しい列挙値PROPSETFLAG_UNBUFFEREDがサポートされています。 詳細については、「 PROPSETFLAG 定数」を参照してください。
この関数は再頒布可能 Iprop.dll からエクスポートされます。これは、Service Pack 2 (SP2) 以降の Windows NT 4.0 に含まれており、Windows 95、Windows 98 以降では再頒布可能パッケージとして使用できます。 Windows 2000 および Windows XP では、ole32.dll からエクスポートされます。 Windows 2000 および Windows XP では iprop.dll からエクスポートすることもできますが、呼び出しは ole32.dll に転送されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | coml2api.h (Propidl.h を含む) |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |