Retour de propriétés à partir d’un gestionnaire de filtres

Les propriétés sont extraites d’éléments à l’aide de gestionnaires de propriétés inscrits ou à l’aide de filtres inscrits pour des types de fichiers spécifiques. Un gestionnaire de filtres (une implémentation de l’interface IFilter ) peut interpréter le contenu d’un type de fichier de plusieurs façons.

Cette rubrique est organisée comme suit :

• Filtrage des propriétés
  • Limitations de taille des propriétés
• Ressources additionnelles
• rubriques connexes

Filtrage des propriétés

Les meilleures pratiques pour le filtrage des propriétés sont répertoriées dans le tableau suivant.

Méthode	Descriptif
IFilter ::Init	Retourne l’énumération IFILTER_FLAGS . Si le membre IFILTER_FLAGS_OLE_PROPERTIES de cette énumération est défini sur un, Windows Search utilise les interfaces IPropertySetStorage et IPropertyStorage pour énumérer et accéder aux propriétés de type valeur externe.
IFilter ::GetChunk	Retourne des informations d’un document dans des « blocs » avec un type de bloc (texte ou valeur), un nom et des paramètres régionaux. Un segment contient une propriété de document.
IFilter ::GetText	Obtient une propriété de type texte à partir d’un bloc.
IFilter ::GetValue	Obtient une propriété de type valeur à partir d’un bloc.

L’illustration suivante montre un exemple de document. La propriété DocTitle de type valeur externe (obtenue à l’aide de méthodes des interfaces IPropertySetStorage et IPropertyStorage ) et la propriété Book de type valeur interne (obtenue à la suite d’une implémentation IFilter personnalisée) décrivent le document dans son ensemble. Les propriétés de type texte Contents et Chapter décrivent le contenu du document. Lors du traitement de ce document, le gestionnaire de filtres (une implémentation de l’interface IFilter ) identifie et extrait ces propriétés.

Limitations de la taille des propriétés

Il existe deux limitations potentielles de la taille des propriétés :

• Taille maximale des données que Windows Search accepte par fichier.
• Taille maximale par propriété définie dans le fichier de description de propriété.

Actuellement, La recherche Windows n’utilise pas la taille de propriété définie lors du calcul de la quantité de données qu’elle accepte à partir d’un élément. Au lieu de cela, la limite utilisée par Windows Search est le produit de la taille du fichier et de la MaxGrowFactor (taille de fichier N * MaxGrowFactor) lues à partir du Registre. La valeur par défaut MaxGrowFactor est de quatre.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

Par conséquent, si votre type de fichier a tendance à être petit en taille totale, mais qu’il possède des propriétés plus grandes, Windows Search peut ne pas accepter toutes les données de propriété que vous souhaitez émettre. Toutefois, vous pouvez augmenter le MaxGrowFactor pour répondre à vos besoins.

Ressources supplémentaires

• L’exemple de code IFilterSample , disponible sur GitHub, montre comment créer une classe de base IFilter pour implémenter l’interface IFilter .
• Pour obtenir une vue d’ensemble du processus d’indexation, consultez Le processus d’indexation.
• Pour obtenir une vue d’ensemble des types de fichiers, consultez Types de fichiers.
• Pour interroger les attributs d'association de fichiers d'un type de fichier, consultez PerceivedTypes, SystemFileAssociations et Enregistrement d'application.
• Pour obtenir une vue d’ensemble des propriétés et des gestionnaires de propriétés et une liste des propriétés système que vous pouvez utiliser pour vos formats de fichiers, consultez Développement de gestionnaires de propriétés pour Windows Search.

Rubriques connexes

Développement de gestionnaires de filtres

À propos des gestionnaires de filtres dans Windows Search

Meilleures pratiques pour la création de gestionnaires de filtres dans Windows Search

Gestionnaires de filtres fournis avec Windows

Implémentation de gestionnaires de filtres dans Windows Search

Inscription de gestionnaires de filtres

Test des gestionnaires de filtres