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

Interroge de manière synchrone l’ordinateur pour l’historique des événements de mise à jour. Cette méthode retourne un pointeur vers une interface IUpdateHistoryEntryCollection qui contient des enregistrements d’événements correspondants sur l’ordinateur.

Syntaxe

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

Paramètres

[in] criteria

Chaîne qui spécifie les critères de recherche.

[in] startIndex

Index du premier événement à récupérer.

[in] count

Nombre d’événements à récupérer.

[out] retval

Pointeur vers une interface IUpdateHistoryEntryCollection qui contient les enregistrements d’événements correspondants sur l’ordinateur dans l’ordre chronologique décroissant.

Valeur retournée

Retourne S_OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows.

Cette méthode peut également retourner les codes d’erreur suivants.

Code de retour Description
E_POINTER
Une valeur de paramètre n’est pas valide ou NULL.
WU_E_INVALID_CRITERIA
Il existe un critère de recherche non valide.

Remarques

La collection d’événements retournée est triée par date dans l’ordre décroissant.

La chaîne utilisée pour le paramètre criteria doit correspondre au langage de recherche personnalisé pour QueryHistory. La chaîne contient des critères qui sont évalués pour déterminer les événements d’historique à retourner.

Notez que QueryHistory prend uniquement en charge les mises à jour par ordinateur.

Pour obtenir une description complète de la syntaxe des critères de recherche, consultez Rechercher.

Le tableau suivant identifie tous les critères de support public, dans l’ordre de priorité de l’évaluation. D’autres critères peuvent être ajoutés à cette liste à l’avenir.

Critère Type Opérateurs autorisés Description
UpdateID string(UUID) = Recherche les mises à jour qui ont un UpdateIdentity.UpdateID de la valeur spécifiée.

Par exemple, « UpdateID='12345678-9abc-def0-1234-56789abcdef0' » recherche des mises à jour pour UpdateIdentity.UpdateID qui sont égales à 12345678-9abc-def0-1234-56789abcdef0.

Configuration requise

   
Client minimal pris en charge Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wuapi.h
Bibliothèque Wuguid.lib
DLL Wuapi.dll

Voir aussi

IUpdateSession3