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

Comienza la ejecución de una búsqueda asincrónica de actualizaciones. La búsqueda usa las opciones de búsqueda que están configuradas actualmente.

Sintaxis

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

Parámetros

[in] criteria

Cadena que especifica los criterios de búsqueda.

[in] onCompleted

Interfaz ISearchCompletedCallback a la que se llama cuando se completa una operación de búsqueda asincrónica.

[in] state

Estado específico del autor de la llamada devuelto por la propiedad AsyncState de la interfaz ISearchJob .

[out] retval

Interfaz ISearchJob que representa la operación actual que podría estar pendiente.

El llamador pasa el valor devuelto al método EndSearch para completar una operación de búsqueda.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un código de error COM o Windows.

Este método también puede devolver los siguientes códigos de error.

Código devuelto	Descripción
E_POINTER	Un valor de parámetro no es válido o NULL.
E_ACCESSDENIED	No se puede llamar a este método desde un equipo remoto.

Comentarios

Para obtener una descripción completa de la sintaxis de los criterios de búsqueda, consulte Búsqueda.

Como alternativa a la implementación de la interfaz ISearchCompletedCallback , puede usar un script para implementar una rutina de devolución de llamada de cualquier identificador con DISPID 0 en un objeto de automatización. El tipo del parámetro onCompleted es IUnknown*.

Al usar cualquier API de WUA asincrónica en la aplicación, es posible que tenga que implementar un mecanismo de tiempo de espera. Para obtener más información sobre cómo realizar operaciones asincrónicas de WUA, consulta Directrices para las operaciones de WUA asincrónicas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wuapi.h
Library	Wuguid.lib
Archivo DLL	Wuapi.dll

Consulte también

IUpdateSearcher