IPropertyStorage インターフェイス (propidlbase.h)

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

IPropertyStorage インターフェイスは、1 つのプロパティセットの永続的なプロパティを管理します。永続的なプロパティは、ファイルに関連付けられている概要情報など、プロパティセットに永続的に格納できる情報で構成されます。これは、システムの動作に影響を与えるために使用できる、Controls と Automation に関連付けられているランタイムプロパティとは対照的です。永続的なプロパティセットを作成または開くには、IPropertySetStorage インターフェイスのメソッドを使用します。 IPropertySetStorage インターフェイスのインスタンスは、0 個以上の IPropertyStorage インスタンスを管理できます。

プロパティセット内の各プロパティは、そのセットに固有の 4 バイト の ULONG 値であるプロパティ識別子 (ID) によって識別されます。 IPropertyStorage インターフェイスを使用して、プロパティに文字列名を割り当てることもできます。

プロパティ ID は、Automation dispid プロパティ名タグで使用されるディスパッチ ID とは異なります。 1 つの違いは、 IPropertyStorage ではプロパティ ID 値 0 と 1 の汎用使用は禁止されていますが、 IDispatch にはそのような制限は存在しません。さらに、 IPropertyStorage と IDispatch で使用できるプロパティ値のデータ型間には大きな重複がありますが、プロパティセットは同じではありません。 IPropertyStorage メソッドで使用される永続的なプロパティデータ型は、PROPVARIANT 構造体で定義されます。

IPropertyStorage インターフェイスを使用して、単純プロパティセットと非単純プロパティセットの両方にアクセスできます。単純でないプロパティセットには、単純なプロパティセットに保持できない複数の複合プロパティ型を保持できます。詳細については、「プロパティセットのストレージオブジェクトとStream オブジェクト」を参照してください。

継承

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

メソッド

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


IPropertyStorage::Commit IPropertyStorage::Commit メソッドは、プロパティストレージオブジェクトに加えられた変更を親ストレージオブジェクトに保存します。
IPropertyStorage::D eleteMultiple IPropertyStorage::D eleteMultiple メソッドは、プロパティセットに存在する指定されたプロパティの数だけ削除します。
IPropertyStorage::D eletePropertyNames IPropertyStorage::D eletePropertyNames メソッドは、指定された文字列名を現在のプロパティセットから削除します。
IPropertyStorage::Enum IPropertyStorage::Enum メソッドは、現在のプロパティセットに関する情報を含む STATPROPSTG 型のデータを列挙するように設計された列挙子オブジェクトを作成します。
IPropertyStorage::ReadMultiple IPropertyStorage::ReadMultiple メソッドは、現在のプロパティセットから指定されたプロパティを読み取ります。
IPropertyStorage::ReadPropertyNames IPropertyStorage::ReadPropertyNames メソッドは、指定されたプロパティ ID の既存の文字列名を取得します。
IPropertyStorage::Revert IPropertyStorage::Revert メソッドは、最後に開いた後に名前付きプロパティセットに対するすべての変更を破棄するか、プロパティセットに最後にコミットされた変更を破棄します。
IPropertyStorage::SetClass IPropertyStorage::SetClass メソッドは、現在のプロパティストレージオブジェクトに新しい CLSID を割り当て、CLSID をオブジェクトと共に永続的に格納します。
IPropertyStorage::SetTimes 実装でサポートされている場合、IPropertyStorage::SetTimes メソッドは、このプロパティセットの変更、アクセス、および作成時間を設定します。
IPropertyStorage::Stat IPropertyStorage::Stat メソッドは、現在開いているプロパティセットに関する情報を取得します。 (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple IPropertyStorage::WriteMultiple メソッドは、指定したプロパティグループを現在のプロパティセットに書き込みます。
IPropertyStorage::WritePropertyNames IPropertyStorage::WritePropertyNames メソッドは、現在のプロパティセット内のプロパティ ID の指定された配列に文字列 IPropertyStoragenames を割り当てます。

要件

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