IDebugControl ::GetEventFilterText, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetEventFilterText retourne une brève description d’un événement pour un filtre spécifique.

Syntaxe

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

Paramètres

[in] Index

Spécifie l’index du filtre d’événements dont la description sera retournée. Seuls les filtres spécifiques ont une description attachée ; index doit faire référence à un filtre spécifique.

[out, optional] Buffer

Reçoit la description du filtre spécifique.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon qui tampon spécifie. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] TextSize

Reçoit la taille de la description de l’événement. Cette taille inclut l’espace du caractère de fin « \0 ». Si TextSize 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.
E_NOINTERFACE	'index n’a pas fait référence à un filtre spécifique. Cela peut se produire si index fait référence à un filtre d’exception arbitraire.