Interface IFilter (filter.h)
Notes
Le service d’indexation n’est plus pris en charge à partir de Windows XP et n’est pas disponible à partir de Windows 8. Au lieu de cela, utilisez Recherche Windows pour la recherche côté client et Microsoft Search Server Express pour la recherche côté serveur.
Analyse les documents à la recherche de texte et de propriétés (également appelées attributs). Il extrait des blocs de texte de ces documents, en filtrant la mise en forme incorporée et en conservant les informations sur la position du texte. Il extrait également des segments de valeurs, qui sont des propriétés d’un document entier ou de parties bien définies d’un document. IFilter fournit la base pour la création d’applications de niveau supérieur, telles que les indexeurs de documents et les visionneuses indépendantes de l’application.
Pour plus d’informations sur le fonctionnement de l’interface IFilter avec les documents et les propriétés de document, consultez Propriétés des documents. Pour obtenir un résumé et un exemple de la façon dont l’interface IFilter traite un document, consultez Filtrage de propriétés et Indexation de propriétés.
Héritage
L’interface IFilter hérite de l’interface IUnknown. IFilter a également les types de membres suivants :
Méthodes
L’interface IFilter possède ces méthodes.
| IFilter ::BindRegion Récupère une interface représentant la partie spécifiée de l’objet. Actuellement réservé pour une utilisation ultérieure. |
| IFilter ::GetChunk Positionne le filtre au début du segment suivant ou au premier segment s’il s’agit du premier appel à la méthode GetChunk et retourne une description du segment actuel. |
| IFilter ::GetText Récupère le texte (propriétés de type texte) du segment actuel, qui doit avoir une valeur d’énumération CHUNKSTATE de CHUNK_TEXT. |
| IFilter ::GetValue Récupère une valeur (propriété de type valeur interne) à partir d’un segment, qui doit avoir une valeur d’énumération CHUNKSTATE de CHUNK_VALUE. |
| IFilter ::Init Initialise une session de filtrage. |
Remarques
Les composants IFilter du service d’indexation s’exécutent dans le contexte de sécurité locale et doivent être écrits pour gérer les mémoires tampons et pour s’empiler correctement. Toutes les copies de chaîne doivent avoir des vérifications explicites pour se prémunir contre les dépassements de mémoire tampon. Vous devez toujours vérifier la taille allouée de la mémoire tampon et tester la taille des données par rapport à la taille de la mémoire tampon.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | filter.h |