IPropertySetStorage::Open メソッド (propidl.h)

[アーティクル]
03/05/2024

Open メソッドは、プロパティセットストレージオブジェクトに含まれるプロパティセットを開きます。

構文

HRESULT Open(
  [in]  REFFMTID         rfmtid,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

パラメーター

[in] rfmtid

開くプロパティセットの書式識別子 (FMTID)。プラットフォーム SDK の既知の FMTID と定義済みの FMTID の詳細については、「定義済みのプロパティセット形式識別子」を参照してください。

[in] grfMode

新しく作成されたプロパティセットを開くアクセスモード。これらのフラグは STGM 定数から取得されます。このメソッドのコンテキストで使用できるフラグとその意味については、次の「解説」セクションで説明します。

[out] ppprstg

要求されたプロパティストレージサブオブジェクトへのインターフェイスポインターを受け取る IPropertyStorage ポインター変数へのポインター。

戻り値

このメソッドは、次に加えて、標準の戻り値E_UNEXPECTEDをサポートしています。

注釈

プロパティセットを開くモードは、パラメーター grfMode で指定します。これらのフラグは STGM 定数から取得されますが、この方法では、有効な値とその意味は次のようになります (これらのフラグ値の特定の組み合わせのみが有効です)。

値	意味
STGM_DIRECT	追加レベルのトランザクション入れ子なしでプロパティセットを開きます。これは既定値です (STGM_DIRECTもSTGM_TRANSACTEDも指定されていない場合の動作)。
STGM_TRANSACTED	追加のレベルのトランザクション入れ子でプロパティセットを開きます (このプロパティセットのストレージオブジェクトでは、トランザクションが存在する場合はそれ以外)。 Transacted モードは、単一でないプロパティセットでのみ使用できます。プロパティセットの変更は、このプロパティセットストレージのトランザクションに表示される前に、IPropertyStorage::Commit の呼び出しでコミットする必要があります。
STGM_READ	読み取りアクセス権を持つプロパティセットを開きます。プロパティセットストレージには読み取り権限が必要です。
STGM_WRITE	書き込みアクセス権を持つプロパティセットを開きます。 IPropertyStorage のすべての実装でこのモードがサポートされているわけではありません。
STGM_READWRITE	読み取りおよび書き込みアクセス権を持つプロパティセットを開きます。このフラグは、STGM_READとSTGM_WRITEの値のバイナリ OR ではないことに注意してください。
STGM_SHARE_DENY_NONE	このプロパティセットストレージからのプロパティセットの後続のオープンは、読み取りまたは書き込みアクセスを拒否されません。 (すべての実装では使用できません。)
STGM_SHARE_DENY_READ	このプロパティセットストレージからのプロパティセットの後続の開始は、読み取りアクセスが拒否されます。すべての実装では使用できません。
STGM_SHARE_DENY_WRITE	このプロパティセットストレージからのプロパティセットの後続のオープンは、書き込みアクセスが拒否されます。この値は通常、複数のユーザーによって開かれたオブジェクトの不要なコピーを作成しないように、トランザクションモードで使用されます。つまり、STGM_TRANSACTEDが指定されていても、この値が指定されていない場合は、後続の開口部があるかどうかに関係なく、スナップショットが作成されます。したがって、この値を指定することでパフォーマンスを向上させることができます。すべての実装では使用できません。
STGM_SHARE_EXCLUSIVE	このプロパティセットストレージからプロパティセットを後続で開くことはできません。この値は、STGM_SHARE_DENY_READおよびSTGM_SHARE_DENY_WRITE要素の単純なバイナリ OR ではないことに注意してください。

このメソッドには、基になる IStorage::OpenStream (単純なプロパティセットの場合) または IStorage::OpenStorage (非単純プロパティセットの場合) の制約が適用されます。単純なプロパティセットと単純でないプロパティセットの詳細については、「プロパティセットのストレージオブジェクトとStreamオブジェクト」を参照してください。たとえば、 IPropertySetStorage-Compound File Implementation を使用する場合は、 grfMode パラメーターで STGM_SHARE_EXCLUSIVE を IPropertySetStorage::Open に指定する必要があります。逆に、 IPropertySetStorage-スタンドアロン実装を使用する場合、 IPropertySetStorage::Open は呼び出し元指定の IStorage に適用される制約の対象となります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	propidl.h (Objbase.h を含む)
Library	Uuid.lib
[DLL]	Ole32.dll