Método IUpdateSession3::QueryHistory (wuapi.h)

  • Artigo

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
E_POINTER
 Um valor de parâmetro é inválido ou NULL.
WU_E_INVALID_CRITERIA
 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

Confira também

IUpdateSession3