Méthode IDebugControl4 ::GetLastEventInformationWide (dbgeng.h)

Article
02/23/2024

La méthode GetLastEventInformationWide retourne des informations sur le dernier événement qui s’est produit dans une cible.

Syntaxe

HRESULT GetLastEventInformationWide(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PWSTR  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 seront retournés à la place.

[out] ThreadId

Reçoit 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 seront retournés à 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 tel qu’indiqué par le paramètre Type retourné. Par exemple, si Type est un point d’arrêt, ExtraInformation contient une DEBUG_LAST_EVENT_INFO_BREAKPOINT ; si Type est Exception, ExtraInformation contient une DEBUG_LAST_EVENT_INFO_EXCEPTION. Reportez-vous à DEBUG_EVENT_XXX pour obtenir la liste complète des types d’événements et le fichier d’en-tête dbgeng.h pour connaître les définitions de structure pour chaque type d’événement.

Si ExtraInformation a lavaleur 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
S_OK	La méthode a réussi.
S_FALSE	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 s’insérer à l’intérieur de la mémoire tampon.

Remarques

Pour les événements de création de thread et de processus, l’ID de thread et l’ID de processus retournés à ThreadId et ProcessId correspondent 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

GetStoredEventInformation

IDebugControl4