IRowsetEvents::OnNewItem-Methode (searchapi.h)

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

Siehe auch

Konzept

IRowsetEvents

IRowsetPrioritization

Indizieren von Priorisierungs- und Rowsetereignissen in Windows 7

PRIORITIZE_FLAGS

PRIORITY_LEVEL

ROWSETEVENT_ITEMSTATE

ROWSETEVENT_TYPE

Referenz

Rowset-Eigenschaften