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.
HRESULT QueryHistory(
[in] BSTR criteria,
[in] LONG startIndex,
[in] LONG count,
[out] IUpdateHistoryEntryCollection **retval
);
[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.
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 |
---|---|
|
Une valeur de paramètre n’est pas valide ou NULL. |
|
Il existe un critère de recherche non valide. |
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. |
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 |