Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Udostępniona przez system autonomiczna implementacja IPropertySetStorage obejmuje implementację IPropertyStorage i IPropertySetStorage.IPropertyStorage to interfejs, który odczytuje i zapisuje właściwości w magazynie zestawu właściwości. IPropertySetStorage to interfejs, który tworzy i otwiera zestawy właściwości w magazynie. Interfejsy IEnumSTATPROPSTG i IEnumSTATPROPSETSTG są również dostępne w implementacji autonomicznej.
Aby użyć autonomicznej implementacji IPropertySetStorage, najpierw uzyskaj wskaźnik do implementacji udostępnionej przez system, autonomicznej i skojarz implementację udostępnioną przez system z obiektem magazynu. Aby uzyskać wskaźnik do autonomicznej implementacji IPropertySetStorage, wywołaj funkcję StgCreatePropSetStg i podaj parametr pStorage określający obiekt magazynu, który będzie zawierać zestaw właściwości. Ta funkcja udostępnia wskaźnik do nowego interfejsu IPropertySetStorage dla określonego obiektu magazynu.
Autonomiczna implementacja IPropertySetStorage tworzy zestawy właściwości na dowolnym obiekcie magazynu, a nie tylko w przypadku złożonych magazynów plików. Implementacja autonomiczna nie zależy od plików złożonych i może być używana z dowolną implementacją magazynów strukturalnych. Wszelkie ograniczenia dotyczące magazynów strukturalnych dostarczanych przez obiekt wywołujący mają zastosowanie do tej implementacji zestawów właściwości. Jeśli na przykład udostępnisz magazyn w trybie prostym do StgOpenPropStg, wynikowy IPropertySetStorage zostanie ograniczony przez podany IStorage.
Aby uzyskać więcej informacji na temat implementacji pliku złożonego tego interfejsu, zobacz sekcję IPropertySetStorage-Compound implementacji plików.
Kiedy należy używać
Wywołaj metody IPropertySetStorage, aby tworzyć, otwierać i usuwać zestawy właściwości w dowolnym magazynie ustrukturyzowanym. Istnieje również metoda, która dostarcza wskaźnik do IEnumSTATPROPSETSTG moduł wyliczający, który może służyć do wyliczania zestawów właściwości w magazynie.
Implementacja autonomiczna udostępnia również funkcje pomocnicze StgCreatePropStg i StgOpenPropStg oprócz Create i Open metod tworzenia i otwierania zestawów właściwości. Te dwie funkcje dodają obsługę wartości PROPSETFLAG_UNBUFFERED, dzięki czemu można zapisywać zmiany bezpośrednio w zestawie właściwości zamiast buforować je w pamięci podręcznej. Aby uzyskać więcej informacji, zobacz PROPSETFLAG Constants.
Metody
Autonomiczna implementacja IPropertySetStorage obsługuje następujące metody.
-
Tworzy nowy zestaw właściwości w magazynie i zwraca wskaźnik do interfejsu IPropertyStorage w zestawie właściwości.
Jeśli planujesz użyć wartości PROPSETFLAG_UNBUFFERED, użyj funkcjiStgCreatePropStg, aby utworzyć i otworzyć nowy zestaw właściwości oraz uzyskać wskaźnik do autonomicznej implementacji dla interfejsu IPropertyStorage w zestawie właściwości.
-
Otwiera istniejącą właściwość ustawioną w magazynie i zwraca wskaźnik do interfejsu IPropertyStorage w zestawie właściwości.
Jeśli planujesz użyć wartości PROPSETFLAG_UNBUFFERED, użyj funkcji StgOpenPropStg, aby uzyskać wskaźnik do autonomicznej implementacji IPropertyStorage w określonym zestawie właściwości.
-
Usuwa zestaw właściwości w tym magazynie zestawu właściwości.
-
Tworzy obiekt, który może służyć do wyliczania struktury STATPROPSETSTG. Każda struktura STATPROPSETSTG dostarcza dane dotyczące pojedynczego zestawu właściwości.
Nuta
Zestaw właściwości DocumentSummaryInformation i UserDefined jest unikatowy, ponieważ może mieć dwie sekcje zestawu właściwości w jednym strumieniu źródłowym. Aby uzyskać więcej informacji, zobacz DocumentSummaryInformation i UserDefined Property Sets .
Tematy pokrewne