Partager via


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

La méthode GetEventFilterCommand retourne la commande de débogueur que le moteur exécutera lorsqu’un événement spécifié se produit.

Syntaxe

HRESULT GetEventFilterCommand(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

Paramètres

[in] Index

Spécifie l’index du filtre d’événements. L’index peut prendre n’importe quelle valeur comprise entre zéro et une valeur inférieure au nombre total de filtres d’événements retournés par GetNumberEventFilters (inclus). Pour plus d’informations sur l’index des filtres, consultez Index et Code d’exception.

[out, optional] Buffer

Reçoit la commande de débogueur que le moteur exécutera lorsque l’événement se produit.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon spécifiée par la mémoire tampon . Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] CommandSize

Reçoit la taille en caractères de la commande. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si CommandSize 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.

Remarques

Pour plus d’informations sur les filtres d’événements, consultez Filtres d’événements.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetExceptionFilterSecondCommand

IDebugControl

IDebugControl2

IDebugControl3

SetEventFilterCommand

sx, sxd, sxe, sxi, sxn (Définir les exceptions)