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

Artículo
03/13/2024

Llamado por el indexador para notificar a los clientes que se ha modificado un elemento. Este elemento puede haber coincidedo con algunos (o todos) de los criterios para el conjunto de filas de cliente.

Sintaxis

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

Parámetros

[in] itemID

Tipo: REFPROPVARIANT

Especifica el elemento del conjunto de filas que ha cambiado.

[in] rowsetItemState

Tipo: ROWSETEVENT_ITEMSTATE

Especifica si el elemento cambiado se encontraba originalmente en el conjunto de filas.

[in] changedItemState

Tipo: ROWSETEVENT_ITEMSTATE

Especifica si el elemento cambiado está actualmente en el conjunto de filas, como resultado del cambio.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El ROWSETEVENT_ITEMSTATE para rowsetItemState indica si el elemento estaba contenido en el conjunto de filas original:

ROWSETEVENT_ITEMSTATE_INROWSET indica que el elemento se encuentra definitivamente dentro del conjunto de filas.
ROWSETEVENT_ITEMSTATE_UNKNOWN indica que el elemento puede estar incluido en el conjunto de filas. El estado de contención no se conoce porque el conjunto de filas no se evalúa completamente.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indica que el elemento no estaba originalmente en el conjunto de filas.

El ROWSETEVENT_ITEMSTATE para changedItemState indica si el elemento recién modificado ahora coincide con el grado en el que el nuevo elemento puede coincidir con los criterios de búsqueda originales de un conjunto de filas:

ROWSETEVENT_ITEMSTATE_INROWSET indica que el elemento pertenece definitivamente al conjunto de filas.
ROWSETEVENT_ITEMSTATE_UNKNOWN indica que el elemento ahora puede pertenecer al conjunto de filas.
ROWSETEVENT_ITEMSTATE_NOTINROWSET indica que el elemento no pertenece al conjunto de filas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	searchapi.h