Zwracanie właściwości z programu obsługi filtrów

Właściwości są wyodrębniane z elementów przy użyciu zarejestrowanych procedur obsługi właściwości lub filtrów zarejestrowanych dla określonych typów plików. Procedura obsługi filtrów (implementacja interfejsu IFilter) może interpretować zawartość typu pliku na dowolną liczbę sposobów.

Ten temat jest zorganizowany w następujący sposób:

Filtrowanie właściwości

W poniższej tabeli wymieniono najlepsze rozwiązania dotyczące filtrowania właściwości.

Metoda Opis
IFilter::Init Zwraca wyliczenie IFILTER_FLAGS. Jeśli element członkowski IFILTER_FLAGS_OLE_PROPERTIES tego wyliczenia jest ustawiony na jeden, usługa Windows Search używa interfejsów IPropertySetStorage i IPropertyStorage do wyliczania i uzyskiwania dostępu do zewnętrznych właściwości typu wartości.
IFilter::GetChunk Zwraca informacje z dokumentu w "fragmentach" z typem fragmentu (tekstem lub wartością), nazwą i ustawieniami regionalnymi. Fragment zawiera jedną właściwość dokumentu.
IFilter::GetText Pobiera właściwość typu tekstowego z fragmentu.
IFilter::GetValue Pobiera właściwość typu wartości z fragmentu.

Na poniższej ilustracji przedstawiono przykładowy dokument. Właściwość typu wartości zewnętrznej DocTitle (uzyskana przy użyciu metod IPropertySetStorage i interfejsów IPropertyStorage) oraz właściwość typu wartości wewnętrznej Book (uzyskana w wyniku niestandardowej implementacji IFilter) opisują dokument jako całość. Właściwości typu tekstowego Contents i Chapter opisują zawartość dokumentu. Podczas przetwarzania tego dokumentu program obsługi filtrów (implementacja interfejsu IFilter) identyfikuje i wyodrębnia te właściwości.

diagram przedstawiający elementy typowego dokumentu

Ograniczenia rozmiaru właściwości

Istnieją dwa potencjalne ograniczenia dotyczące rozmiaru nieruchomości:

  • Maksymalny rozmiar danych akceptowanych przez usługę Windows Search na plik.
  • Maksymalny rozmiar właściwości zgodnie z definicją w pliku opisu właściwości.

Obecnie usługa Windows Search nie używa zdefiniowanego rozmiaru właściwości podczas obliczania ilości danych, które akceptuje z elementu. Zamiast tego limit stosowany przez Windows Search wynika z pomnożenia rozmiaru pliku przez MaxGrowFactor (rozmiar pliku N * MaxGrowFactor) odczytanego z rejestru. Domyślny MaxGrowFactor to cztery.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

W związku z tym, jeśli typ pliku jest zwykle mały, ale ma większe właściwości, usługa Windows Search może nie akceptować wszystkich danych właściwości, które chcesz emitować. Można jednak zwiększyć MaxGrowFactor zgodnie z potrzebami.

Dodatkowe zasoby

tworzenie programów obsługi filtrów

Informacje o programach obsługi filtrów w usłudze Windows Search

najlepsze rozwiązania dotyczące tworzenia programów obsługi filtrów w usłudze Windows Search

programy obsługi filtrów dostarczane z systemem Windows

Wdrażanie obsług filtrów w usłudze Windows Search

rejestrowanie programów obsługi filtrów

Testowanie obsługi filtrów