IRowsetEvents 인터페이스(searchapi.h)

아티클
08/25/2023

이벤트 알림을 받기 위한 메서드를 노출합니다. 클라이언트가 이 인터페이스를 구현할 때 인덱서는 새 항목 추가, 항목 삭제 및 항목 데이터 수정을 포함하여 행 집합의 항목에 대한 변경 내용을 클라이언트에 알릴 수 있습니다.

상속

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 인터페이스는 열린 인덱서 행 집합이 있는 연결 지점에 의해 등록됩니다.

행 집합 이벤트를 사용하려면 쿼리를 실행하기 전에 OLE DB ICommandProperties::SetProperties 메서드를 사용하여 DBPROP_ENABLEROWSETEVENTS TRUE로 설정해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	searchapi.h