Méthode IDebugControl3 ::GetLastEventInformation (dbgeng.h)

Article
02/23/2024

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
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 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.