IRowsetEvents::OnChangedItem-Methode (searchapi.h)

Artikel
03/01/2024

Wird vom Indexer aufgerufen, um Clients zu benachrichtigen, dass ein Element geändert wurde. Dieses Element hat möglicherweise einige (oder alle) Kriterien für das Clientrowset erfüllt.

Syntax

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

Parameter

[in] itemID

Typ: REFPROPVARIANT

Gibt das Element im Rowset an, das geändert wurde.

[in] rowsetItemState

Typ: ROWSETEVENT_ITEMSTATE

Gibt an, ob das geänderte Element ursprünglich im Rowset enthalten war.

[in] changedItemState

Typ: ROWSETEVENT_ITEMSTATE

Gibt an, ob sich das geänderte Element als Ergebnis der Änderung derzeit im Rowset befindet.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die ROWSETEVENT_ITEMSTATE für rowsetItemState gibt an, ob das Element im ursprünglichen Rowset enthalten war:

ROWSETEVENT_ITEMSTATE_INROWSET gibt an, dass das Element definitiv in Ihrem Rowset enthalten ist.
ROWSETEVENT_ITEMSTATE_UNKNOWN gibt an, dass das Element in Ihrem Rowset enthalten sein kann. Die Eindämmung status ist nicht bekannt, da Ihr Rowset nicht vollständig ausgewertet wird.
ROWSETEVENT_ITEMSTATE_NOTINROWSET gibt an, dass das Element ursprünglich nicht in Ihrem Rowset enthalten war.

Die ROWSETEVENT_ITEMSTATE für changedItemState gibt an, ob das neu geänderte Element nun dem Grad entspricht, in dem das neue Element möglicherweise den ursprünglichen Suchkriterien eines Rowsets entspricht:

ROWSETEVENT_ITEMSTATE_INROWSET gibt an, dass das Element definitiv in Ihr Rowset gehört.
ROWSETEVENT_ITEMSTATE_UNKNOWN gibt an, dass das Element jetzt in Ihr Rowset gehört.
ROWSETEVENT_ITEMSTATE_NOTINROWSET gibt an, dass das Element nicht in Ihr Rowset gehört.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h