Поделиться через

Метод ISearchCrawlScopeManager2::GetVersion (searchapi.h)

  • Статья

Вызывает сопоставление файлов с адресным пространством вызывающего процесса и информирует клиентов об изменении состояния диспетчера области обхода контента (CSM).

Синтаксис

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

Параметры

[out] plVersion

Тип: LONG**

Получает указатель на адрес сопоставленного файла памяти, содержащего версию область обхода контента.

[out] phFileMapping

Тип: HANDLE*

Получает указатель на дескриптор объекта сопоставления файлов с доступом только для чтения, который использовался для создания сопоставленного файла в памяти, содержащего версию область обхода.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Полученный номер версии всегда является текущим и изменяется как состояние CSM, например, были ли добавлены или удалены в область обхода контента. Поэтому ISearchCrawlScopeManager2::GetVersion необходимо вызывать только один раз, так как текущая версия всегда остается доступной через полученный указатель.

ISearchCrawlScopeManager2::GetVersion не приводит к межпроцессному вызову. Если метод выполнен успешно, клиент должен выполнить следующие действия, чтобы уничтожить все представления файлов в своем адресном пространстве, а затем закрыть дескриптор объекта сопоставления файлов и файл на диске:

  • Вызов unmapViewOfFile с помощью указателя файла, сопоставленного с памятью, предоставленного plVersion
  • Вызов CloseHandle с помощью дескриптора объекта сопоставления файлов
Клиент должен выполнить эти действия по завершении использования сопоставленного файла памяти, чтобы предотвратить утечку памяти.

Windows 7 и более поздних версий. Ознакомьтесь с примером кода CrawlScopeCommandLine , чтобы узнать, как определить параметры командной строки для операций индексирования в диспетчере области обхода контента (CSM).

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header searchapi.h