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

  • Article

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 une valeur (propriété de type valeur interne) à partir d’un segment, qui doit avoir une valeur d’énumération CHUNKSTATE de CHUNK_VALUE.

Syntaxe

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Paramètres

[out] ppPropValue

Pointeur vers une variable de sortie qui reçoit un pointeur vers la structure PROPVARIANT qui contient la propriété value-type.

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_MORE_VALUES
La méthode GetValue a déjà été appelée sur ce segment ; cette valeur doit être retournée jusqu’à ce que la méthode IFilter::GetChunk ait été appelée avec succès et ait atteint le segment suivant.
FILTER_E_NO_VALUES
 Le segment actuel n’a pas de valeur d’énumération CHUNKSTATE de CHUNK_VALUE.

Notes

Appelez la méthode GetValue une seule fois par segment.

Notez que l’effet de la production de la même valeur à partir de plusieurs segments n’est pas défini. Seul le dernier paramètre de la valeur est valide.

Notes aux appelants

Allouez la structure PROPVARIANT avec CoTaskMemAlloc. Certaines structures PROPVARIANT contiennent des pointeurs, qui peuvent être libérés en appelant la fonction PropVariantClear . Il appartient à l’appelant de la méthode GetValue d’appeler PropVariantClear.

Spécifications

   
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

Ifilter