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

Artigo
08/25/2023

Chamado pelo indexador para notificar os clientes de que um item foi modificado. Este item pode ter correspondido a alguns (ou todos) dos critérios do conjunto de linhas do cliente.

Sintaxe

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

Parâmetros

[in] itemID

Tipo: REFPROPVARIANT

Especifica o item no conjunto de linhas que foi alterado.

[in] rowsetItemState

Tipo: ROWSETEVENT_ITEMSTATE

Especifica se o item alterado estava originalmente no conjunto de linhas.

[in] changedItemState

Tipo: ROWSETEVENT_ITEMSTATE

Especifica se o item alterado está atualmente no conjunto de linhas, como resultado da alteração.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O ROWSETEVENT_ITEMSTATE para rowsetItemState indica se o item estava contido no conjunto de linhas original:

ROWSETEVENT_ITEMSTATE_INROWSET indica que o item está definitivamente contido no conjunto de linhas.
ROWSETEVENT_ITEMSTATE_UNKNOWN indica que o item pode estar contido no conjunto de linhas. A status de contenção não é conhecida porque o conjunto de linhas não está totalmente avaliado.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indica que o item não estava originalmente no conjunto de linhas

O ROWSETEVENT_ITEMSTATE para changedItemState indica se o item recém-modificado agora corresponde ao grau em que o novo item pode corresponder aos critérios de pesquisa originais de um conjunto de linhas:

ROWSETEVENT_ITEMSTATE_INROWSET indica que o item definitivamente pertence ao conjunto de linhas.
ROWSETEVENT_ITEMSTATE_UNKNOWN indica que o item agora pode pertencer ao conjunto de linhas.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indica que o item não pertence ao conjunto de linhas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	searchapi.h