StgOpenPropStg

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

StgOpenPropStg pUnk, fmtid, grfFlags, dwReserved, ppPropStg

pUnk : [var] 要求されたプロパティセットオブジェクトを含むストレージまたはストリームオブジェクト上の IUnknown インターフェイスへのインターフェイスポインタ。
fmtid : [var] 開かれるプロパティセットの FMTID。
grfFlags : [int] PROPSETFLAG Constants からの値。
dwReserved : [int] 将来の使用のために予約されており、ゼロでなければならない。
ppPropStg : [var] 要求されたプロパティセットへのインターフェイスポインタを受け取る IPropertyStorage* ポインタ変数へのポインタ。

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

解説

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

[戻り値]
この関数は標準の戻り値 E_INVALIDARG と E_UNEXPECTED に加えて、以下をサポートする：

[備考]
StgOpenPropStg は要求されたプロパティセットを開き、IPropertyStorage
インターフェイスのシステム提供のスタンドアロン実装を提供する。要求されたプロパティセットは pUnk
で指定されたストレージまたはストリームオブジェクトに含まれる。grfFlags パラメータの値は、pUnk
がストレージオブジェクトを指定するかストリームオブジェクトを指定するかを示す。たとえば、PROPSETFLAG_NONSIMPLE
が設定されている場合、pUnk はストレージオブジェクト上の IStorage
インターフェイスについてクエリできる。いずれの場合も、この関数はプロパティセットを含むストレージまたはストリームオブジェクトに対して
pUnk->AddRef を呼び出す。呼び出し元はオブジェクトが不要になったら解放しなければならない。この関数は
IPropertySetStorage::Open メソッドに似ている。ただし、StgOpenPropStg は pUnk と
grfFlags パラメータを追加し、grfFlags パラメータの PROPSETFLAG_UNBUFFERED
値を含む。IPropertySetStorage インターフェイスをサポートしない IStorage インターフェイスがある場合、または
PROPSETFLAG_UNBUFFERED 値を使用したい場合は、Open
メソッドの代わりにこの関数を使用する。PROPSETFLAG_UNBUFFERED の使用方法の詳細については PROPSETFLAG
Constants を参照のこと。grfFlags パラメータは PROPSETFLAG Constants
からの値の組み合わせである。新しい列挙値 PROPSETFLAG_UNBUFFERED がサポートされる。詳細については
PROPSETFLAG Constants を参照のこと。この関数は再頒布可能な iprop.dll からエクスポートされており、これは
Windows NT 4.0 with Service Pack 2 (SP2) に含まれており、Windows 95
以降では再頒布可能として利用できる。Windows 2000 では Ole32.dll からエクスポートされる。Windows 2000
では iprop.dll からもエクスポートできるが、呼び出しは ole32.dll に転送される。

情報