implementacja plików IEnumSTATPROPSTG-Compound

Implementacja pliku złożonego interfejsu IEnumSTATPROPSTG służy do wyliczania właściwości, co powoduje struktury STATPROPSTG, które zawierają dane właściwości statystycznych. Implementacja IPropertyStorage zarządza danymi statystycznymi i jest skojarzona z bieżącym obiektem magazynu plików złożonych.

Konstruktor w implementacji COM IEnumSTATPROPSTG tworzy klasę, która odczytuje cały zestaw właściwości, i tworzy tablicę statyczną, którą można udostępnić, gdy IEnumSTATPROPSTG::Clone jest wywoływana.

Kiedy należy używać

Wywołaj implementację pliku złożonego IEnumSTATPROPSTG, aby wyliczyć struktury STATPROPSTG zawierające dane o właściwościach w bieżącym zestawie właściwości. W przypadku korzystania z implementacji plików złożonych interfejsów magazynu właściwości wywołaj IPropertyStorage::Enum, aby zwrócić wskaźnik do IEnumSTATPROPSTG do zarządzania obiektem magazynu właściwości i elementami w nim.

Uwagi

IEnumSTATPROPSTG::Next

Pobiera kolejną lub więcej struktur STATPROPSTG (liczba jest określana przez parametr celt). Zwraca wartość S_OK w przypadku powodzenia.

IEnumSTATPROPSTG::Skip

Pomija liczbę elementów określonych w celt. Następny element do wyliczenia za pomocą wywołania dalej staje się elementem po pominiętych elementach. Zwraca S_OK, jeśli elementów celt zostały pominięte; zwraca S_FALSE, jeśli pominięto elementy celt.

IEnumSTATPROPSTG::Resetuj

Ustawia kursor na początek wyliczenia. Jeśli operacja powiedzie się, zwraca S_OK, w przeciwnym razie zwraca STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

Używa konstruktora dla IEnumSTATPROPSTG, aby utworzyć kopię tablicy. Ponieważ klasa, która konstruuje tablicę statyczną, rzeczywiście zawiera obiekt, ta funkcja dodaje głównie do liczby odwołań.

Tematy pokrewne

STATPROPSTG

IPropertyStorage::Enum