Méthode IDebugControl2 ::SetExceptionFilterParameters (dbgeng.h)

Article
02/23/2024

La méthode SetExceptionFilterParameters modifie la status d’arrêt et la gestion des status pour certains filtres d’exception.

Syntaxe

HRESULT SetExceptionFilterParameters(
  [in] ULONG                              Count,
  [in] PDEBUG_EXCEPTION_FILTER_PARAMETERS Params
);

Paramètres

[in] Count

Spécifie le nombre de filtres d’exception dont les paramètres doivent être modifiés.

[in] Params

Spécifie un tableau de paramètres de filtre d’exception de type DEBUG_EXCEPTION_FILTER_PARAMETERS. Seuls les champs ExecutionOption, ContinueOption et ExceptionCode de ces paramètres sont utilisés. Le champ ExceptionCode permet d’identifier l’exception dont le filtre d’exception sera modifié. ExceptionOption spécifie le nouveau status d’arrêt et ContinueOption spécifie le nouveau status de gestion.

Si la valeur du champ ExceptionOption est DEBUG_FILTER_REMOVE et que le filtre d’exception est un filtre d’exception arbitraire, le filtre d’exception est supprimé.

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_OUTOFMEMORY	Nombre maximal de filtres d’exceptions arbitraires a été dépassé.

Remarques

Pour chacun des paramètres de filtre d’exception dans Params, si l’exception, identifiée par le code d’exception, a déjà un filtre (spécifique ou arbitraire), ce filtre est modifié. Sinon, un nouveau filtre d’exception arbitraire est ajouté pour l’exception.

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