Implementacje zestawu właściwości w modelu COM

Chociaż możliwość użycia trwałych zestawów właściwości nie jest w pełni zamapowana, obecnie istnieją dwa podstawowe zastosowania:

• Przechowywanie informacji podsumowania z obiektem, takim jak dokument
• Transferowanie danych właściwości między obiektami

Zestawy właściwości COM zostały zaprojektowane do przechowywania danych, które są odpowiednie do reprezentowania jako umiarkowanie wielkości kolekcji precyzyjnych wartości. Zestawy danych, które są zbyt duże, aby można je było wykonać, należy podzielić na oddzielne strumienie, magazyny i/lub zestawy właściwości. Format danych zestawu właściwości COM nie był przeznaczony do zapewnienia zastąpienia bazy danych wielu małych obiektów.

Com udostępnia implementacje interfejsów zestawu właściwości dla różnych obiektów wraz z trzema funkcjami pomocnika. W poniższej sekcji opisano niektóre cechy wydajności tych implementacji. Aby uzyskać więcej informacji na temat określonych interfejsów i sposobu uzyskiwania wskaźnika do tych interfejsów, zapoznaj się z następującymi informacjami w sekcji referencyjnej modelu COM:

• implementacji plików złożonych IPropertySetStorage

  Implementacja pliku złożonego, która udostępnia interfejsy IStorage i IStreamIStream, udostępnia również interfejsy IPropertySetStorage i IPropertyStorage. Biorąc pod uwagę implementację pliku złożonego IStorage, interfejs IPropertySetStorage można uzyskać, wywołując interfejs IUnknown::QueryInterface.

• implementacji systemu plików IPropertySetStorage–NTFS

  Interfejsy IPropertySetStorage i IPropertyStorage można również uzyskać dla plików NTFS, które nie są plikami złożonymi. W związku z tym można uzyskać te interfejsy dla wszystkich plików na woluminie NTFS.

• IPropertySetStorage — autonomiczna implementacja

  Po utworzeniu wystąpienia tej implementacji IPropertySetStorage i IPropertyStorage jest wyświetlany wskaźnik do obiektu obsługującego interfejs IStorage. Następnie manipuluje magazynami zestawu właściwości w tym obiekcie magazynu. W związku z tym istnieje możliwość uzyskiwania dostępu do zestawów właściwości i manipulowania nimi na dowolnym obiekcie obsługującym funkcję .

• zagadnienia dotyczące implementacji IPropertySetStorage

  Istnieje kilka problemów, które należy wziąć pod uwagę podczas udostępniania implementacji interfejsu IPropertySetStorage. Zapoznaj się z tymi zagadnieniami dotyczącymi implementacji w sekcji Dokumentacja modelu COM.

Ponadto istnieją cztery funkcje pomocnicze, które ułatwiają radzenie sobie z właściwościami, które zostały odczytane z zestawu właściwości do pamięci (do struktury PROPVARIANT):

• PropVariantInit
• PropVariantClear
• FreePropVariantArray
• PropVariantCopy

W poniższych sekcjach omówiono bardziej szczegółowo implementacje zestawu właściwości w modelu COM:

• zarządzanie zestawami właściwości
• zagadnienia dotyczące zestawu właściwości
• przechowywanie zestawów właściwości
• charakterystykę wydajności
• implementowanie zestawu właściwości informacji podsumowania
• zagadnienia dotyczące implementacji IPropertySetStorage