StgCreatePropStg

指定されたストレージまたはストリームオブジェクト内にプロパティセットを作成して開く。

StgCreatePropStg pUnk, fmtid, pclsid, grfFlags, dwReserved, ppPropStg

pUnk : [var] 新しいプロパティセットを格納するストレージまたはストリームオブジェクト上の IUnknown インターフェイスへのポインタ。
fmtid : [var] 作成されるプロパティセットの FMTID。
pclsid : [var] このプロパティセットの初期 CLSID へのポインタ。NULL でもよく、その場合 pclsid はすべてゼロに設定される。
grfFlags : [int] プロパティセットがどのように作成され開かれるかを決定する、PROPSETFLAG Constants からの値。
dwReserved : [int] 予約。ゼロでなければならない。
ppPropStg : [var] 新しいプロパティセットへのインターフェイスポインタを受け取る IPropertyStorage* ポインタ変数のアドレス。

(プラグイン / モジュール : ole32.dll)

解説

指定されたストレージまたはストリームオブジェクト内にプロパティセットを作成して開く。

[戻り値]
この関数は標準の戻り値 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 Constants
を参照のこと。プロパティセットは自動的にコードページとロケール識別子（ID）プロパティを含む。これらはそれぞれ現在のシステムの既定値と現在のユーザの既定値に設定される。grfFlags
パラメータは PROPSETFLAG Constants からの値の組み合わせである。新しい列挙値
PROPSETFLAG_UNBUFFERED がサポートされる。詳細については PROPSETFLAG Constants
を参照のこと。この関数は再頒布可能な Iprop.dll からエクスポートされており、これは Windows NT 4.0 with
Service Pack 2 (SP2) 以降に含まれており、Windows 95、Windows 98
以降では再頒布可能として利用できる。Windows 2000 と Windows XP では ole32.dll
からエクスポートされる。Windows 2000 と Windows XP では iprop.dll
からもエクスポートできるが、呼び出しは ole32.dll に転送される。

情報