다음을 통해 공유


변경 내용 인덱스 알림(레거시 Windows 환경 기능)

참고

Windows Desktop Search 2.x는 원래 Windows XP 및 Windows Server 2003용 추가 기능으로 사용할 수 있었던 사용되지 않는 기술입니다. 이후 릴리스에서는 Windows Search 를 대신 사용합니다.

Microsoft WDS(Windows Desktop Search) 2.6을 사용하면 지정된 데이터 저장소에 대한 프로토콜 처리기가 저장소의 데이터가 변경된 경우 WDS 인덱서에 알릴 수 있습니다. 이렇게 하면 인덱서가 증분 인덱스에서 전체 저장소를 크롤링하지 않도록 하여 성능을 향상시킵니다. 프로토콜 처리기는 알림 API를 사용하여 항목이 이동 또는 삭제되었음을 인덱서에 알릴 수 있으며 인덱싱이 필요한 WDS 인덱서의 크롤링 큐에 범위를 추가할 수 있습니다. 알림은 프로토콜 처리기가 저장소를 모니터링하고 인덱서에 항목이 변경되었으며 인덱싱이 필요하다고 알리는 이메일과 같은 애플리케이션에 유용합니다.

ISearchItemsChangedSink

프로토콜 처리기는 ISearchItemsChangedSink 인터페이스를 통해 인덱서에 변경 내용을 알립니다. 데이터 변경에 대한 정보는 SEARCH_ITEM_CHANGE 구조체 및 SEARCH_KIND_OF_CHANGE 열거형 형식에서 수집한 다음 ISearchItemsChangedSink 인터페이스의 OnItemsChanged 메서드를 통해 Indexer에 전달되어야 합니다.

이 인터페이스에 액세스하려면 사용자 지정 프로토콜 처리기가 먼저 ISearchManager 개체를 인스턴스화하여 ISearchCatalogManager 개체에 대한 액세스 권한을 얻어야 합니다. 여기에서 ISearchItemsChangedSink 개체를 인스턴스화하고 인덱서에 데이터 변경 내용을 알릴 수 있습니다.

OnItemsChanged 메서드를 사용하면 데이터 변경 내용을 수집하고 고객 데이터 저장소에 전달하여 인덱싱을 시작할 수 있습니다.

Direction 변수 설명
In(다음 안에) dwNumberofChanges 알림의 총 변경 횟수입니다.
In(다음 안에) DataChangeEntries[] SEARCH_ITEM_CHANGE 구조의 배열에 있는 모든 변경 알림입니다.
아웃 dwBatchId 오류와 함께 다시 전달될 일괄 처리 ID입니다.
아웃 hrCompletionCodes[] 각 URL이 인덱싱에 허용되었는지 여부를 나타냅니다.

 

SEARCH_ITEM_CHANGE 구조체는 항목의 현재 URL 및 이전 URL(해당하는 경우)뿐만 아니라 발생한 변경의 종류를 식별합니다. 구조체는 다음과 같이 정의됩니다.

속성 이름 속성 유형 Description
변경 SEARCH_KIND_OF_CHANGE 알림을 받을 변경 유형입니다.
URL LPWSTR 변경된 개체의 URL입니다.
OldURL LPWSTR 알림이 이동인 경우 이전 URL이 제공되며 고유해야 합니다.
우선 순위 SEARCH_NOTIFICATION_PRIORITY 변경의 우선 순위입니다.

 

SEARCH_KIND_OF_CHANGE 열거형은 다음과 같이 정의됩니다.

열거형 값 Description
SEARCH_CHANGE_ADD 0 추가 URL에 대한 알림입니다.
SEARCH_CHANGE_DELETE 1 URL 삭제 알림입니다.
SEARCH_CHANGE_MODIFY 2 URL이 수정되었다는 알림입니다.
SEARCH_CHANGE_MOVE_RENAME 3 알림은 개체를 새 URL로 이동하고 이름을 바꾸는 것입니다.
SEARCH_CHANGE_SEMANTICS_DIRECTORY 0x10000 컨테이너 URL에 대한 알림입니다.
SEARCH_CHANGE_SEMANTICS_SHALLOW 0x20000 알림은 컨테이너 속성만 인덱싱해야 하는 컨테이너 URL에 대한 것입니다.
SEARCH_CHANGE_SEMANTICS_SECURITY 0x40000 알림은 보안 속성이 변경된 URL 또는 컨테이너 URL에 대한 것입니다.

 

SEARCH_NOTIFICATION_PRIORITY 열거형은 다음과 같이 정의됩니다.

열거형 값 Description
SEARCH_NORMAL_PRIORITY 0 URL을 인덱싱할 때는 일반 우선 순위만 사용해야 합니다. 이러한 알림은 사용자 파일 및 저장소의 일반적인 백그라운드 증분 인덱싱 전에 처리됩니다.