Compartilhar via


Método IUpdateSearcher::EndSearch (wuapi.h)

Conclui uma pesquisa assíncrona para atualizações.

Sintaxe

HRESULT EndSearch(
  [in]  ISearchJob    *searchJob,
  [out] ISearchResult **retval
);

Parâmetros

[in] searchJob

A interface ISearchJob que o método BeginSearch retorna.

[out] retval

Uma interface ISearchResult que contém o seguinte:

  • O resultado de uma operação
  • Uma coleção de atualizações que correspondem aos critérios de pesquisa

Valor retornado

Retorna S_OK se tiver êxito. Caso contrário, retornará um código de erro COM ou Windows.

Esse método também pode retornar os seguintes códigos de erro.

Código de retorno Descrição
S_OK
Uma pesquisa assíncrona para atualizações é bem-sucedida.
WU_E_LEGACYSERVER
Não é possível pesquisar atualizações se a propriedade ServerSelection de IUpdateSearcher estiver definida como ssManagedServer ou como ssDefault, e o servidor gerenciado em um computador for um servidor do Microsoft Software Update Services (SUS) 1.0.
E_POINTER
Um valor de parâmetro é inválido ou NULL.
E_ACCESSDENIED
Esse método não pode ser chamado de um computador remoto.
WU_E_INVALID_OPERATION
O método EndSearch retornará WU_E_INVALID_OPERATION se EndSearch já tiver sido chamado para o trabalho de pesquisa.
WU_E_INVALID_CRITERIA
Um critério inválido foi encontrado durante uma pesquisa.

Comentários

Ao usar qualquer API WUA assíncrona em seu aplicativo, talvez seja necessário implementar um mecanismo de tempo limite. Para obter mais informações sobre como executar operações WUA assíncronas, consulte Diretrizes para operações WUA assíncronas.

Requisitos

   
Cliente mínimo com suporte Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wuapi.h
Biblioteca Wuguid.lib
DLL Wuapi.dll

Confira também

IUpdateSearcher