변경 내용 인덱스 알림(레거시 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을 인덱싱할 때는 일반 우선 순위만 사용해야 합니다. 이러한 알림은 사용자 파일 및 저장소의 일반적인 백그라운드 증분 인덱싱 전에 처리됩니다. |