Metodo IUpdateSession3::QueryHistory (wuapi.h)

Articolo
08/28/2023

Esegue una query sincrona sul computer per la cronologia degli eventi di aggiornamento. Questo metodo restituisce un puntatore a un'interfaccia IUpdateHistoryEntryCollection che contiene record eventi corrispondenti nel computer.

Sintassi

HRESULT QueryHistory(
  [in]  BSTR                          criteria,
  [in]  LONG                          startIndex,
  [in]  LONG                          count,
  [out] IUpdateHistoryEntryCollection **retval
);

Parametri

[in] criteria

Stringa che specifica i criteri di ricerca.

[in] startIndex

Indice del primo evento da recuperare.

[in] count

Numero di eventi da recuperare.

[out] retval

Puntatore a un'interfaccia IUpdateHistoryEntryCollection che contiene i record eventi corrispondenti nel computer in ordine cronologico decrescente.

Valore restituito

Restituisce S_OK in caso di esito positivo. In caso contrario, restituisce un codice di errore COM o Windows.

Questo metodo può anche restituire i codici di errore seguenti.

Codice restituito	Descrizione
E_POINTER	Un valore di parametro non è valido o NULL.
WU_E_INVALID_CRITERIA	Esiste un criterio di ricerca non valido.

Commenti

La raccolta di eventi restituiti viene ordinata in base alla data in ordine decrescente.

La stringa utilizzata per il parametro criteria deve corrispondere al linguaggio di ricerca personalizzato per QueryHistory. La stringa contiene criteri che vengono valutati per determinare quali eventi della cronologia restituire.

Si noti che QueryHistory supporta solo gli aggiornamenti per computer.

Per una descrizione completa della sintassi dei criteri di ricerca, vedere Ricerca.

La tabella seguente identifica tutti i criteri di supporto pubblico, nell'ordine di precedenza di valutazione. Altri criteri possono essere aggiunti a questo elenco in futuro.

Criterio	Tipo	Operatori consentiti	Descrizione
UpdateID	string(UUID)	=	Trova gli aggiornamenti con updateIdentity.UpdateID del valore specificato. Ad esempio, "UpdateID='12345678-9abc-def0-1234-56789abcdef0'" trova gli aggiornamenti per UpdateIdentity.UpdateID uguale a 12345678-9abc-def0-1234-56789abcdef0.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wuapi.h
Libreria	Wuguid.lib
DLL	Wuapi.dll

Vedi anche

IUpdateSession3

Condividi tramite