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

Article
08/28/2023

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

Partager via