Méthode IDebugControl3 ::GetLastEventInformation (dbgeng.h)
La méthode GetLastEventInformation retourne des informations sur le dernier événement qui s’est produit dans une cible.
Syntaxe
HRESULT GetLastEventInformation(
[out] PULONG Type,
[out] PULONG ProcessId,
[out] PULONG ThreadId,
[out, optional] PVOID ExtraInformation,
[in] ULONG ExtraInformationSize,
[out, optional] PULONG ExtraInformationUsed,
[out, optional] PSTR Description,
[in] ULONG DescriptionSize,
[out, optional] PULONG DescriptionUsed
);
Paramètres
[out] Type
Reçoit le type du dernier événement généré par la cible. Pour obtenir la liste des types possibles, consultez DEBUG_EVENT_XXX.
[out] ProcessId
Reçoit l’ID de processus du processus dans lequel l’événement s’est produit. Si ces informations ne sont pas disponibles, DEBUG_ANY_ID sont retournées à la place.
[out] ThreadId
Reçoit l’index de thread (et non l’ID de thread) du thread dans lequel le dernier événement s’est produit. Si ces informations ne sont pas disponibles, DEBUG_ANY_ID sont retournées à la place.
[out, optional] ExtraInformation
Reçoit des informations supplémentaires sur l’événement. Le contenu de ces informations supplémentaires dépend du type de l’événement. Si ExtraInformation a la valeur NULL, ces informations ne sont pas retournées.
[in] ExtraInformationSize
Spécifie la taille, en octets, de la mémoire tampon spécifiée par ExtraInformation .
[out, optional] ExtraInformationUsed
Reçoit la taille, en octets, des informations supplémentaires. Si ExtraInformationUsed a la valeur NULL, ces informations ne sont pas retournées.
[out, optional] Description
Reçoit la description de l’événement. Si Description a la valeur NULL, ces informations ne sont pas retournées.
[in] DescriptionSize
Spécifie la taille, en caractères, de la mémoire tampon spécifiée par Description . Cette taille inclut l’espace pour le caractère de fin « \0 ».
[out, optional] DescriptionUsed
Reçoit la taille en caractères de la description de l’événement. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si DescriptionUsed a la valeur NULL, ces informations ne sont pas retournées.
Valeur retournée
Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.
Code de retour | Description |
---|---|
|
La méthode a réussi. |
|
La méthode a réussi. Toutefois, ExtraInformationSize ou DescriptionSize étaient plus petits que la taille des données ou chaînes respectives et les données ou chaînes ont été tronquées pour tenir à l’intérieur de la mémoire tampon. |
Remarques
Pour les événements de création de thread et de processus, l’index de thread et l’ID de processus retournés à ThreadId et ProcessId sont destinés au thread ou au processus nouvellement créé.
Pour plus d’informations sur le dernier événement, consultez la rubrique Informations sur l’événement.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour