Método IUpdateSession3::QueryHistory (wuapi.h)
Consulta sincrónicamente el equipo para conocer el historial de eventos de actualización. Este método devuelve un puntero a una interfaz IUpdateHistoryEntryCollection que contiene registros de eventos coincidentes en el equipo.
Sintaxis
HRESULT QueryHistory(
[in] BSTR criteria,
[in] LONG startIndex,
[in] LONG count,
[out] IUpdateHistoryEntryCollection **retval
);
Parámetros
[in] criteria
Cadena que especifica los criterios de búsqueda.
[in] startIndex
Índice del primer evento que se va a recuperar.
[in] count
Número de eventos que se van a recuperar.
[out] retval
Puntero a una interfaz IUpdateHistoryEntryCollection que contiene los registros de eventos coincidentes en el equipo en orden cronológico descendente.
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 |
|---|---|
|
Un valor de parámetro no es válido o NULL. |
|
Hay un criterio de búsqueda no válido. |
Comentarios
La colección de eventos que se devuelve se ordena por la fecha en orden descendente.
La cadena que se usa para el parámetro criteria debe coincidir con el lenguaje de búsqueda personalizado de QueryHistory. La cadena contiene criterios que se evalúan para determinar qué eventos de historial se van a devolver.
Tenga en cuenta que QueryHistory solo admite actualizaciones por máquina.
Para obtener una descripción completa de la sintaxis de los criterios de búsqueda, consulte Búsqueda.
En la tabla siguiente se identifican todos los criterios de soporte técnico público, en el orden de prioridad de evaluación. Se pueden agregar más criterios a esta lista en el futuro.
| Criterio | Tipo | Operadores permitidos | Descripción |
|---|---|---|---|
| UpdateID | string(UUID) | = |
Busca las actualizaciones que tienen updateIdentity.UpdateID del valor especificado.
Por ejemplo, "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" busca actualizaciones para UpdateIdentity.UpdateID que son iguales a 12345678-9abc-def0-1234-56789abcdef0. |
Requisitos
| 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 |