StgCreatePropStg 関数 (coml2api.h)

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

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