Метод IRowsetEvents::OnChangedItem (searchapi.h)

Статья
08/25/2023

Вызывается индексатором для уведомления клиентов об изменении элемента. Этот элемент мог соответствовать некоторым (или всем) критериям для набора строк клиента.

Синтаксис

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

Параметры

[in] itemID

Тип: REFPROPVARIANT

Указывает элемент в наборе строк, который был изменен.

[in] rowsetItemState

Тип: ROWSETEVENT_ITEMSTATE

Указывает, был ли измененный элемент изначально в наборе строк.

[in] changedItemState

Тип: ROWSETEVENT_ITEMSTATE

Указывает, находится ли измененный элемент в наборе строк в результате изменения.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

ROWSETEVENT_ITEMSTATE_INROWSET указывает, что элемент определенно содержится в наборе строк.
ROWSETEVENT_ITEMSTATE_UNKNOWN указывает, что элемент может содержаться в наборе строк. Состояние вложенности неизвестно, так как набор строк не вычисляется полностью.
ROWSETEVENT_ITEMSTATE_NOTINROWSET указывает, что элемент изначально не входил в набор строк.

ROWSETEVENT_ITEMSTATE для changedItemState указывает, соответствует ли измененный элемент степени, в которой новый элемент может соответствовать исходным условиям поиска набора строк:

ROWSETEVENT_ITEMSTATE_INROWSET указывает, что элемент определенно принадлежит набору строк.
ROWSETEVENT_ITEMSTATE_UNKNOWN указывает, что элемент теперь может принадлежать набору строк.
ROWSETEVENT_ITEMSTATE_NOTINROWSET указывает, что элемент не принадлежит набору строк.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	searchapi.h