ISearchCrawlScopeManager2::GetVersion 메서드(searchapi.h)

파일 매핑이 호출 프로세스의 주소 공간에 매핑되도록 하고 CSM(크롤링 범위 관리자)의 상태가 변경된 경우 클라이언트에 알립니다.

구문

HRESULT GetVersion(
  [out] long   **plVersion,
  [out] HANDLE *phFileMapping
);

매개 변수

[out] plVersion

형식: LONG**

크롤링 scope 버전이 포함된 메모리 매핑 파일의 주소에 대한 포인터를 받습니다.

[out] phFileMapping

형식: HANDLE*

크롤링 scope 버전을 포함하는 메모리 매핑 파일을 만드는 데 사용된 읽기 전용 액세스 권한이 있는 파일 매핑 개체의 핸들에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

검색되는 버전 번호는 항상 최신 상태이며 크롤링 scope 추가 또는 제거가 수행되었는지 여부와 같은 CSM의 상태로 변경됩니다. 따라서 현재 버전은 항상 검색된 포인터를 통해 사용할 수 있으므로 ISearchCrawlScopeManager2::GetVersion 을 한 번만 호출해야 합니다.

ISearchCrawlScopeManager2::GetVersion 은 프로세스 간 호출을 발생시키지 않습니다. 메서드가 성공하면 클라이언트는 다음 작업을 수행하여 주소 공간의 모든 파일 뷰를 삭제한 다음 파일 매핑 개체의 핸들과 디스크의 파일을 닫아야 합니다.

  • plVersion에서 제공하는 메모리 매핑 파일의 포인터를 사용하여 UnmapViewOfFile 호출
  • 파일 매핑 개체의 핸들을 사용하여 CloseHandle 호출
메모리 누수 방지를 위해 클라이언트는 메모리 매핑 파일 사용을 완료할 때 이러한 단계를 수행해야 합니다.

Windows 7 이상: CrawlScopeCommandLine 코드 샘플을 확인하여 CSM(크롤링 범위 관리자) 인덱싱 작업에 대한 명령줄 옵션을 정의하는 방법을 확인합니다.

요구 사항

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