Eigenschappen retourneren van een filterhandler

Artikel
15-03-2025

Eigenschappen worden geëxtraheerd uit items met behulp van geregistreerde eigenschapshandlers of door filters te gebruiken die zijn geregistreerd voor specifieke bestandstypen. Een filterhandler (een implementatie van de IFilter interface) kan de inhoud van een bestandstype op verschillende manieren interpreteren.

Dit onderwerp is als volgt ingedeeld:

Eigenschappenfiltering
- Beperkingen van eigendomsgroottes
Aanvullende bronnen
Verwante onderwerpen

Filteren van eigenschappen

Aanbevolen procedures voor het filteren van eigenschappen worden vermeld in de volgende tabel.

Methode	Beschrijving
IFilter::Init	Retourneert de opsomming IFILTER_FLAGS. Als het IFILTER_FLAGS_OLE_PROPERTIES lid van deze opsomming is ingesteld op één, gebruikt Windows Search de IPropertySetStorage- en IPropertyStorage interfaces om externe waardetype-eigenschappen te inventariseren en te benaderen.
IFilter::GetChunk	Retourneert informatie uit een document in segmenten met segmenttype (tekst of waarde), naam en landinstelling. Een segment bevat één documenteigenschap.
IFilter::GetText	Hiermee haalt u een teksttype-eigenschap op uit een segment.
IFilter::GetValue-	Hiermee haalt u een eigenschap van het waardetype op uit een segment.

In de volgende afbeelding ziet u een voorbeelddocument. De eigenschap van het externe waardetype DocTitle (verkregen met behulp van methoden van de IPropertySetStorage en IPropertyStorage interfaces) en de interne eigenschap van het waardetype Book (verkregen als gevolg van een aangepaste IFilter-implementatie) beschrijft het document als geheel. De eigenschappen van het teksttype Contents en Chapter de inhoud van het document beschrijven. Bij het verwerken van dit document identificeert en extraheert de filterhandler (een implementatie van de IFilter interface) deze eigenschappen.

diagram met de elementen van een typisch document

Beperkingen voor eigenschapsgrootte

Er zijn twee mogelijke beperkingen voor de grootte van eigenschappen:

De maximale grootte van gegevens die door Windows Search per bestand worden geaccepteerd.
De maximale grootte per eigenschap zoals gedefinieerd in het beschrijvingsbestand van de eigenschap.

Op dit moment gebruikt Windows Search niet de gedefinieerde eigenschapsgrootte bij het berekenen van de hoeveelheid gegevens die wordt geaccepteerd van een item. In plaats daarvan is de limiet die Windows Search gebruikt het product van de grootte van het bestand en de waarde MaxGrowFactor (bestandsgrootte N * MaxGrowFactor) die uit het register wordt gelezen. De standaard MaxGrowFactor is vier.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

Als uw bestandstype meestal klein is, maar grotere eigenschappen heeft, accepteert Windows Search mogelijk niet alle eigenschapsgegevens die u wilt verzenden. U kunt echter de MaxGrowFactor verhogen om aan uw behoeften te voldoen.

Aanvullende informatiebronnen

Het codevoorbeeld IFilterSample, beschikbaar op GitHub-, laat zien hoe u een IFilter-basisklasse maakt voor het implementeren van de IFilter--interface.
Zie Het indexeringsprocesvoor een overzicht van het indexeringsproces.
Zie Bestandstypenvoor een overzicht van bestandstypen.
Zie PerceivedTypes, SystemFileAssociations en Application Registrationals u een query wilt uitvoeren op kenmerken van bestandskoppelingen voor een bestandstype.
Zie Property Handlers ontwikkelen voor Windows Searchvoor een overzicht van eigenschappen en eigenschappenverwerkers en een lijst met systeemeigenschappen die u kunt gebruiken voor uw bestandsindelingen.