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

Article
02/26/2024

La méthode GetExceptionFilterSecondCommandWide retourne la commande qui sera exécutée par le moteur de débogueur à la deuxième chance d’une exception spécifiée.

Syntaxe

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

Paramètres

[in] Index

Spécifie l’index du filtre d’exception dont la commande de deuxième chance sera retournée. Index peut également faire référence au filtre d’exception par défaut pour renvoyer la commande de deuxième chance pour les exceptions qui n’ont pas de filtre d’exception spécifique ou arbitraire.

[out, optional] Buffer

Reçoit la commande de deuxième chance pour le filtre d’exception.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon spécifiée par Buffer . 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 de deuxième chance pour le filtre d’exception. 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

Seuls les filtres d’exception prennent en charge une commande de deuxième chance. Si Index fait référence à un filtre d’événements spécifique, la commande retournée à Buffer est vide. La commande retournée est également vide si aucune commande de seconde chance n’a été définie pour l’exception spécifiée.

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