Интерфейс IRowsetEvents (searchapi.h)
Предоставляет методы для получения уведомлений о событиях. Когда клиенты реализуют этот интерфейс, индексатор может уведомлять клиентов об изменениях элементов в наборах строк, включая добавление новых элементов, удаление элементов и изменение данных элемента.
Наследование
Интерфейс IRowsetEvents наследуется от интерфейса IUnknown . IRowsetEvents также имеет следующие типы элементов:
Методы
Интерфейс IRowsetEvents содержит следующие методы.
| IRowsetEvents::OnChangedItem Вызывается индексатором для уведомления клиентов об изменении элемента. Этот элемент мог соответствовать некоторым (или всем) критериям для набора строк клиента. |
| IRowsetEvents::OnDeletedItem Вызывается индексатором для уведомления клиентов об удалении элемента. Этот элемент мог соответствовать некоторым (или всем) условиям поиска для набора строк клиента. |
| IRowsetEvents::OnNewItem Вызывается индексатором для уведомления клиентов о новом элементе, который может соответствовать некоторым (или всем) условиям для набора строк клиента. |
| IRowsetEvents::OnRowsetEvent Вызывается индексатором для уведомления клиентов о событии, связанном с набором строк клиента. |
Комментарии
Когда следует реализовать
Реализуйте IRowsetEvents, если поставщик должен получать уведомления о событиях набора строк. IRowsetEvents предоставляет методы для получения уведомлений о событиях и должен быть реализован для получения следующих уведомлений о событиях: OnChangedItem, OnDeletedItem, OnNewItem и OnRowsetEvent. Перечислители ROWSETEVENT_ITEMSTATE и ROWSETEVENT_TYPE фиксируют состояние элемента и событие набора строк соответственно.События индексатора — это новая функция для Windows 7, которая позволяет поставщикам получать уведомления о своих наборах строк. Поставщики могут использовать события для поддержания своих наборов строк таким образом, чтобы они велись аналогично фактическим расположениям файловой системы.
Интерфейс IRowsetEvents регистрируется точкой подключения с открытым набором строк индексатора.
DBPROP_ENABLEROWSETEVENTS необходимо задать значение TRUE с помощью метода OLE DB ICommandProperties::SetProperties перед выполнением запроса, чтобы использовать события набора строк.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | searchapi.h |
См. также раздел
Основные понятия
Индексирование приоритетов и событий набора строк в Windows 7
Процесс уведомлений (Поиск Windows)
Справочные материалы