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

Inicia a execução de uma pesquisa assíncrona para atualizações. A pesquisa usa as opções de pesquisa que estão configuradas no momento.

Sintaxe

HRESULT BeginSearch(
  [in]  BSTR       criteria,
  [in]  IUnknown   *onCompleted,
  [in]  VARIANT    state,
  [out] ISearchJob **retval
);

Parâmetros

[in] criteria

Uma cadeia de caracteres que especifica os critérios de pesquisa.

[in] onCompleted

Uma interface ISearchCompletedCallback que é chamada quando uma operação de pesquisa assíncrona é concluída.

[in] state

O estado específico do chamador retornado pela propriedade AsyncState da interface ISearchJob .

[out] retval

Uma interface ISearchJob que representa a operação atual que pode estar pendente.

O chamador passa o valor retornado para o método EndSearch para concluir uma operação de pesquisa.

Retornar valor

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
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.

Comentários

Para obter uma descrição completa da sintaxe de critérios de pesquisa, consulte Pesquisar.

Como alternativa à implementação da interface ISearchCompletedCallback , você pode usar um script para implementar uma rotina de retorno de chamada de qualquer identificador com DISPID 0 em um objeto de automação. O tipo do parâmetro onCompleted é IUnknown*.

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

Requisito	Valor
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