IPropertySetStorage インターフェイス (propidl.h)

[アーティクル]
03/15/2023

IPropertySetStorage インターフェイスは、IPropertyStorage インターフェイスのインスタンスをサポートするプロパティセットストレージを作成、開き、削除、および列挙します。 IPropertyStorage インターフェイスは、プロパティストレージサブオブジェクト内の 1 つのプロパティセットを管理します。IPropertySetStorage インターフェイスは、このようなプロパティセットのグループのストレージを管理します。どのファイルシステムエンティティでも、COM 複合ファイルオブジェクトに現在実装されている IPropertySetStorage をサポートできます。

IPropertySetStorage インターフェイスと IPropertyStorage インターフェイスは、これらのセットが IStorage をサポートするストレージオブジェクトに存在するかどうかに関係なく、プロパティセットを作成および管理するための統一された方法を提供します。 IStorage (構造化ファイルや複合ファイルなど) または IStream をサポートするオブジェクトを介して呼び出された場合、作成されるプロパティセットは COM プロパティセット形式に準拠します。詳細については、「構造化ストレージシリアル化されたプロパティセット形式」を参照してください。同様に、 IStorage を使用して COM プロパティセット形式に書き込まれたプロパティは 、IPropertySetStorage と IPropertyStorage を通じて表示されます。

IPropertySetStorage メソッドは、書式識別子 (FMTID) と呼ばれるグローバル一意識別子 (GUID) を使用してプロパティセットを識別します。プロパティセットの FMTID は、プロパティセット内のプロパティ識別子、その意味、および値に対する制約を識別します。プロパティセットの FMTID には、そのプロパティセットを操作する手段も用意されている必要があります。 1 つのプロパティストレージ内に一度に存在できるのは、特定の FMTID のインスタンスが 1 つだけです。

継承

IPropertySetStorage インターフェイスは、IUnknown インターフェイスから継承されます。 IPropertySetStorage には、次の種類のメンバーもあります。

メソッド

IPropertySetStorage インターフェイスには、これらのメソッドがあります。


IPropertySetStorage::Create プロパティセットのストレージオブジェクトに新しいプロパティセットを作成して開きます。
IPropertySetStorage::D elete Delete メソッドは、プロパティセットストレージオブジェクトに含まれるプロパティセットの 1 つを削除します。
IPropertySetStorage::Enum Enum メソッドは、このプロパティセットストレージに格納されているプロパティセットに関する情報を含む列挙子オブジェクトを作成します。戻り値の場合、このメソッドは列挙子オブジェクトの IEnumSTATPROPSETSTG ポインターへのポインターを提供します。
IPropertySetStorage::Open プロパティセットストレージオブジェクトに含まれるプロパティセットを開きます。

注釈

メモ上記の DocumentSummaryInformation および UserDefined プロパティセットには例外があります。このプロパティセットは、1 つの基になるストリームに 2 つのプロパティセットセクションがある可能性がある点で一意です。このプロパティセットについては、「 DocumentSummaryInformation および UserDefined プロパティセット」を参照してください。最初のセクションは DocumentSummaryInformation プロパティセットです。 2 番目のセクションは、UserDefined プロパティセットです。各セクションは、一意の書式識別子 (FMTID) によって識別されます。たとえば、プロパティセットFMTID_DocSummaryInformation FMTID_UserDefinedします。これら 2 つのプロパティセットが 1 つのストリームに存在できることは、 IPropertySetStorage インターフェイスの動作に影響します。

UserDefined プロパティセットを作成するために IPropertySetStorage::Create が呼び出されると、最初のセクションが自動的に作成されます。 FMTID_UserDefinedPropertiesが作成されたら、FMTID_DocSummaryInformationを作成する必要はありませんが、 IPropertySetStorage::Open を呼び出して開くことができます。最初のセクションを作成しても、2 番目のセクションは自動的に作成されず、両方のセクションを同時に開くことはできません。

IPropertySetStorage::D elete を呼び出して最初のセクションを削除すると、両方のセクションが削除されます。つまり、 IPropertySetStorage::D elete を FMTID_DocSummaryInformation で呼び出すと、そのセクションと FMTID_UserDefinedProperties セクションの両方が削除されます。ただし、2 番目のセクションを削除しても、最初のセクションは自動的に削除されません。

IPropertySetStorage::Enum を使用してプロパティセットを列挙する場合、UserDefined プロパティセットは列挙されません。

要件

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