Méthode IDebugControl ::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 pour 2000 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 est utilisé pour identifier l’exception dont le filtre d’exception sera modifié. ExceptionOption spécifie la nouvelle status d’arrêt et ContinueOption spécifie la nouvelle 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’exception 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 sera modifié. Dans le cas contraire, un nouveau filtre d’exception arbitraire sera ajouté pour l’exception.

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