IPropertySetStorage –samostatná implementace

Systém poskytovaná samostatná implementace IPropertySetStorage zahrnuje implementaci IPropertyStorage a IPropertySetStorage.IPropertyStorage je rozhraní, které čte a zapisuje vlastnosti v úložišti sady vlastností. IPropertySetStorage je rozhraní, které vytváří a otevírá sady vlastností v úložišti. Rozhraní IEnumSTATPROPSTG a IEnumSTATPROPSETSTG jsou také poskytována v samostatné implementaci.

Chcete-li použít samostatnou implementaci IPropertySetStorage, nejprve získejte ukazatel na systém poskytovanou samostatnou implementaci a přidružte implementaci poskytovanou systémem k objektu úložiště. Pokud chcete získat ukazatel na samostatnou implementaci IPropertySetStorage, zavolejte StgCreatePropSetStg funkce a zadejte pStorage parametr určující objekt úložiště, který bude obsahovat sadu vlastností. Tato funkce poskytuje ukazatel na nové IPropertySetStorage rozhraní pro zadaný objekt úložiště.

Samostatná implementace IPropertySetStorage vytváří sady vlastností pro jakýkoli objekt úložiště, nejen ve složených souborových úložištích. Samostatná implementace nezávisí na složených souborech a lze ji použít s jakoukoli implementací strukturovaných úložišť. Všechna omezení strukturovaných úložišť poskytovaných volajícím se vztahují na tuto implementaci sad vlastností. Pokud například zadáte jednoduché úložiště pro StgOpenPropStg, bude výsledný IPropertySetStorage omezen zadaným IStorage.

Další informace o implementaci složeného souboru tohoto rozhraní naleznete v části IPropertySetStorage-Compound Implementace souboru.

Kdy použít

Volání metod IPropertySetStorage vytvořit, otevřít a odstranit sady vlastností v jakémkoli strukturovaném úložišti. Existuje také metoda, která poskytuje ukazatel na IEnumSTATPROPSETSTG enumerátor, který lze použít k vytvoření výčtu sad vlastností v úložišti.

Samostatná implementace také poskytuje StgCreatePropStg a StgOpenPropStg pomocné funkce, kromě Create a Open metody vytvářet a otevírat sady vlastností. Tyto dvě funkce přidávají podporu pro hodnotu PROPSETFLAG_UNBUFFERED, takže můžete zapisovat změny přímo do sady vlastností místo ukládání do vyrovnávací paměti do mezipaměti. Další informace naleznete v tématu PROPSETFLAG Konstanty.

Metody

Samostatná implementace IPropertySetStorage podporuje následující metody.

IPropertySetStorage::Create

Vytvoří novou sadu vlastností v úložišti a vrátí ukazatel na IPropertyStorage rozhraní v sadě vlastností.

Pokud plánujete použít hodnotu PROPSETFLAG_UNBUFFERED, použijte místo toho funkci StgCreatePropSt g vytvořit a otevřít novou sadu vlastností a získat ukazatel na samostatnou implementaci pro IPropertyStorage rozhraní sady vlastností.

IPropertySetStorage::Open

Otevře existující sadu vlastností v úložišti a vrátí ukazatel na IPropertyStorage rozhraní sady vlastností.

Pokud plánujete použít hodnotu PROPSETFLAG_UNBUFFERED, použijte funkci StgOpenPropStg místo toho získat ukazatel na samostatnou implementaci IPropertyStorage v zadané sadě vlastností.

IPropertySetStorage::D elete

Odstraní vlastnost nastavenou v tomto úložišti sady vlastností.

IPropertySetStorage::Enum

Vytvoří objekt, který lze použít k vytvoření výčtu STATPROPSETSTG struktur. Každá struktura STATPROPSETSTG poskytuje data o jedné sadě vlastností.

Poznámka

Vlastnost DocumentSummaryInformation a UserDefined je jedinečná v tom, že může mít dva oddíly sady vlastností v jednom podkladovém datovém proudu. Další informace naleznete v DocumentSummaryInformation a UserDefined Sady vlastností .

 

implementace IPropertyStorage–samostatná implementace

IPropertySetStorage

IPropertyStorage

IStorage::EnumElements

konstanty PROPSETFLAG

STATPROPSETSTG

stgCreatePropSetStg

stgCreatePropStg

StgOpenPropStg

konstanty STGM