Método IUpdateSession3::QueryHistory (wuapi.h)
Consulta o computador de forma síncrona para o histórico de eventos de atualização. Esse método retorna um ponteiro para uma interface IUpdateHistoryEntryCollection que contém registros de evento correspondentes no computador.
Sintaxe
HRESULT QueryHistory(
[in] BSTR criteria,
[in] LONG startIndex,
[in] LONG count,
[out] IUpdateHistoryEntryCollection **retval
);
Parâmetros
[in] criteria
Uma cadeia de caracteres que especifica os critérios de pesquisa.
[in] startIndex
O índice do primeiro evento a ser recuperado.
[in] count
O número de eventos a serem recuperados.
[out] retval
Um ponteiro para uma interface IUpdateHistoryEntryCollection que contém os registros de evento correspondentes no computador em ordem cronológica decrescente.
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 |
|---|---|
|
Um valor de parâmetro é inválido ou NULL. |
|
Há um critério de pesquisa inválido. |
Comentários
A coleção de eventos retornados é classificada pela data em ordem decrescente.
A cadeia de caracteres usada para o parâmetro criteria deve corresponder à linguagem de pesquisa personalizada para QueryHistory. A cadeia de caracteres contém critérios que são avaliados para determinar quais eventos de histórico retornar.
Observe que QueryHistory dá suporte apenas a atualizações por computador.
Para obter uma descrição completa da sintaxe de critérios de pesquisa, consulte Pesquisar.
A tabela a seguir identifica todos os critérios de suporte público, na ordem de precedência de avaliação. Mais critérios podem ser adicionados a essa lista no futuro.
| Critério | Tipo | Operadores permitidos | Descrição |
|---|---|---|---|
| UpdateID | string(UUID) | = |
Localiza atualizações que têm um UpdateIdentity.UpdateID do valor especificado.
Por exemplo, "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" localiza atualizações para UpdateIdentity.UpdateID que são iguais a 12345678-9abc-def0-1234-56789abcdef0. |
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 |