Méthode IFilter ::GetText (filter.h)

Article
03/02/2024

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.

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.

Syntaxe

SCODE GetText(
  [in, out] ULONG *pcwcBuffer,
  [out]     WCHAR *awcBuffer
);

Paramètres

[in, out] pcwcBuffer

Lors de l’entrée, la taille du tableau awcBuffer en caractères larges/Unicode. À la sortie, le nombre de caractères Unicode écrits dans awcBuffer.

[out] awcBuffer

Texte récupéré à partir du segment actuel. Ne terminez pas la mémoire tampon avec un caractère. Utilisez une chaîne terminée par null. La chaîne terminée par null ne doit pas dépasser la taille de la mémoire tampon de destination.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	L’opération s’est terminée avec succès.
FILTER_E_NO_TEXT	Le membre des indicateurs de la structure STAT_CHUNK pour le segment actuel n’a pas la valeur CHUNK_TEXT.
FILTER_E_NO_MORE_TEXT	Tout le texte du segment actuel a été retourné. Les appels supplémentaires à la méthode GetText doivent renvoyer cette erreur jusqu’à ce que la méthode IFilter ::GetChunk ait été appelée avec succès.
FILTER_S_LAST_TEXT	En guise d’optimisation, le dernier appel qui retourne du texte peut renvoyer FILTER_S_LAST_TEXT, indiquant que l’appel suivant à la méthode GetText retournera FILTER_E_NO_MORE_TEXT. Cette optimisation peut faire gagner du temps en éliminant les appels inutiles à GetText.

Remarques

Si le segment actuel est trop grand pour le tableau awcBuffer , plusieurs appels à la méthode GetText peuvent être nécessaires pour récupérer tout le texte du segment actuel. Chaque appel à la méthode GetText récupère le texte qui suit immédiatement le texte du dernier appel à la méthode GetText . Le dernier caractère d’un appel peut se trouver au milieu d’un mot, et le premier caractère de l’appel suivant continuerait ce mot. Les moteurs de recherche doivent gérer cette situation.

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

Voir aussi

CHUNKSTATE

Ifilter