IDebugControl3 ::GetLastEventInformation, méthode (dbgeng.h)

Article
02/06/2025

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 sera retourné à 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 sera retourné à 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 est NULL, ces informations ne sont pas retournées.

[in] ExtraInformationSize

Spécifie la taille, en octets, de la mémoire tampon qui ExtraInformation spécifie.

[out, optional] ExtraInformationUsed

Reçoit la taille, en octets, d’informations supplémentaires. Si ExtraInformationUsed est NULL, ces informations ne sont pas retournées.

[out, optional] Description

Reçoit la description de l’événement. Si Description est NULL, ces informations ne sont pas retournées.

[in] DescriptionSize

Spécifie la taille, en caractères, de la mémoire tampon qui Description spécifie. Cette taille inclut l’espace du 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 du caractère de fin « \0 ». Si DescriptionUsed est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, ExtraInformationSize ou DescriptionSize étaient plus petites que la taille des données ou de la chaîne respectives et les données ou chaînes étaient tronquées pour s’adapter à 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 concernent le thread ou le processus nouvellement créé.

Pour plus d’informations sur le dernier événement, consultez la rubrique Informations sur l’événement.