IRowsetEvents::OnNewItem-Methode (searchapi.h)

Artikel
08/25/2023

Wird vom Indexer aufgerufen, um Clients über ein neues Element zu benachrichtigen, das möglicherweise einigen (oder allen) der Kriterien für das Clientrowset entspricht.

Syntax

HRESULT OnNewItem(
  [in] REFPROPVARIANT        itemID,
  [in] ROWSETEVENT_ITEMSTATE newItemState
);

Parameter

[in] itemID

Typ: REFPROPVARIANT

Das neue Element, das möglicherweise mit den ursprünglichen Suchkriterien des Rowsets übereinstimmt.

[in] newItemState

Typ: ROWSETEVENT_ITEMSTATE

Gibt als ROWSETEVENT_ITEMSTATE-Enumeration an, ob das neue Element alle oder einige Kriterien für Ihr Rowset erfüllt.

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 gibt den Grad an, in dem das neue Element den ursprünglichen Suchkriterien eines Rowsets entspricht:

ROWSETEVENT_ITEMSTATE_INROWSET gibt an, dass das neue Element definitiv allen Kriterien für Ihr Rowset entspricht.
ROWSETEVENT_ITEMSTATE_UNKNOWN gibt an, dass das neue Element zumindest teilweise einigen Kriterien für Ihr Rowset entspricht. Es kann vollständig übereinstimmen.
ROWSETEVENT_ITEMSTATE_NOTINROWSET gilt nicht für neue Elemente.

Anforderungen


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