Compartilhar via

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

  • Artigo

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
O cliente deve executar essas etapas quando terminar de usar o arquivo mapeado de memória para evitar vazamentos de memória.

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

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho searchapi.h