Compartir a través de

Método ISearchCrawlScopeManager2::GetVersion (searchapi.h)

  • Artículo

Hace que la asignación de archivos se asigne al espacio de direcciones del proceso de llamada y informa a los clientes si ha cambiado el estado del Administrador de ámbitos de rastreo (CSM).

Sintaxis

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

Parámetros

[out] plVersion

Tipo: LONG**

Recibe un puntero a la dirección de un archivo asignado a memoria que contiene la versión del ámbito de rastreo.

[out] phFileMapping

Tipo: HANDLE*

Recibe un puntero al identificador del objeto de asignación de archivos, con acceso de solo lectura, que se usó para crear el archivo asignado a memoria que contiene la versión del ámbito de rastreo.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El número de versión que se recupera siempre es actual y cambia como el estado del CSM, como si se realizaron adiciones o eliminaciones en el ámbito de rastreo, por ejemplo. Por lo tanto, se debe llamar a ISearchCrawlScopeManager2::GetVersion solo una vez, ya que la versión actual siempre permanece disponible a través del puntero recuperado.

ISearchCrawlScopeManager2::GetVersion no da lugar a una llamada entre procesos. Si el método se realiza correctamente, el cliente debe realizar las siguientes acciones para destruir todas las vistas de archivo en su espacio de direcciones y, a continuación, cerrar el identificador del objeto de asignación de archivos y el archivo en el disco:

  • Llame a UnmapViewOfFile mediante el puntero del archivo asignado a memoria proporcionado por plVersion.
  • Llamar a CloseHandle mediante el identificador del objeto de asignación de archivos
El cliente debe realizar estos pasos cuando termine de usar el archivo asignado a memoria para evitar pérdidas de memoria.

Windows 7 y versiones posteriores: consulte el ejemplo de código CrawlScopeCommandLine para ver cómo definir opciones de línea de comandos para las operaciones de indexación de Crawl Scope Manager (CSM).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado searchapi.h