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

Article
02/29/2024

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 associée ; L’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 spécifiée par Buffer . Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] TextSize

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