Méthode IRowsetEvents ::OnChangedItem (searchapi.h)

Article
02/01/2024

Appelé par l’indexeur pour informer les clients qu’un élément a été modifié. Cet élément a peut-être correspondu à une partie (ou à la totalité) des critères de l’ensemble de lignes client.

Syntaxe

HRESULT OnChangedItem(
  [in] REFPROPVARIANT        itemID,
  [in] ROWSETEVENT_ITEMSTATE rowsetItemState,
  [in] ROWSETEVENT_ITEMSTATE changedItemState
);

Paramètres

[in] itemID

Type : REFPROPVARIANT

Spécifie l’élément de l’ensemble de lignes qui a été modifié.

[in] rowsetItemState

Type : ROWSETEVENT_ITEMSTATE

Spécifie si l’élément modifié se trouvait à l’origine dans l’ensemble de lignes.

[in] changedItemState

Type : ROWSETEVENT_ITEMSTATE

Spécifie si l’élément modifié se trouve actuellement dans l’ensemble de lignes, à la suite de la modification.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La ROWSETEVENT_ITEMSTATE pour l’ensemble de lignesItemState indique si l’élément était contenu dans l’ensemble de lignes d’origine :

ROWSETEVENT_ITEMSTATE_INROWSET indique que l’élément est définitivement contenu dans votre ensemble de lignes.
ROWSETEVENT_ITEMSTATE_UNKNOWN indique que l’élément peut être contenu dans votre ensemble de lignes. Le status de confinement n’est pas connu, car votre ensemble de lignes n’est pas entièrement évalué.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indique que l’élément n’était pas à l’origine dans votre ensemble de lignes

L’ROWSETEVENT_ITEMSTATE pour changedItemState indique si l’élément nouvellement modifié correspond maintenant au degré auquel le nouvel élément peut correspondre aux critères de recherche d’origine d’un ensemble de lignes :

ROWSETEVENT_ITEMSTATE_INROWSET indique que l’élément appartient définitivement à votre ensemble de lignes.
ROWSETEVENT_ITEMSTATE_UNKNOWN indique que l’élément peut maintenant appartenir à votre ensemble de lignes.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indique que l’élément n’appartient pas à votre ensemble de lignes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h