Compartilhar via


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

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

Sintaxe

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

Parâmetros

[in] searchJob

A interface ISearchJob retornada pelo método BeginSearch .

[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 de retorno

Retorna S_OK se bem-sucedido. Caso contrário, retorna 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 Description
S_OK
Uma pesquisa assíncrona por atualizações é bem-sucedida.
WU_E_LEGACYSERVER
Você não poderá pesquisar atualizações se a propriedade ServerSelection de IUpdateSearcher estiver definida como ssManagedServer ou 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.

Observações

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 assíncronas de WUA.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header wuapi.h
Library Wuguid.lib
de DLL Wuapi.dll

Consulte também

IUpdateSearcher