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

Faz com que o mapeamento de arquivos seja mapeado para o espaço de endereço do processo de chamada e informa aos clientes se o estado do Gerenciador de Escopo de Rastreamento (CSM) foi alterado.

Sintaxe

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

Parâmetros

[out] plVersion

Tipo: LONG**

Recebe um ponteiro para o endereço de um arquivo mapeado de memória que contém a versão do escopo de rastreamento.

[out] phFileMapping

Tipo: HANDLE*

Recebe um ponteiro para o identificador do objeto de mapeamento de arquivo, com acesso somente leitura, que foi usado para criar o arquivo mapeado de memória que contém a versão do escopo de rastreamento.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O número de versão recuperado é sempre atual e é alterado como o estado do CSM, como se adições ou remoções foram feitas no escopo de rastreamento, por exemplo. Portanto, ISearchCrawlScopeManager2::GetVersion precisa ser chamado apenas uma vez, pois a versão atual sempre permanece disponível por meio do ponteiro recuperado.

ISearchCrawlScopeManager2::GetVersion não resulta em uma chamada entre processos. Se o método for bem-sucedido, o cliente deverá executar as seguintes ações para destruir todas as exibições de arquivo em seu espaço de endereço e, em seguida, fechar o identificador do objeto de mapeamento de arquivo e o arquivo no disco:

• Chamar UnmapViewOfFile usando o ponteiro do arquivo mapeado na memória fornecido pelo plVersion
• Chamar CloseHandle usando o identificador do objeto de mapeamento de arquivo

Windows 7 e posterior: confira o exemplo de código CrawlScopeCommandLine para ver como definir opções de linha de comando para operações de indexação do Gerenciador de Escopo de Rastreamento (CSM).

Requisitos