IDebugControl3::SetExceptionFilterParameters-Methode (dbgeng.h)

Artikel
02/06/2025

Die SetExceptionFilterParameters Methode ändert den Unterbrechungsstatus und Behandlungsstatus für einige Ausnahmefilter.

Syntax

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

Parameter

[in] Count

Gibt die Anzahl der Ausnahmefilter an, für die die Parameter geändert werden sollen.

[in] Params

Gibt ein Array von Ausnahmefilterparametern vom Typ DEBUG_EXCEPTION_FILTER_PARAMETERSan. Es werden nur die felder ExecutionOption, ContinueOptionund ExceptionCode Felder dieser Parameter verwendet. Das feld ExceptionCode wird verwendet, um die Ausnahme zu identifizieren, deren Ausnahmefilter geändert wird. ExceptionOption- gibt den neuen Unterbrechungsstatus an, und ContinueOption gibt den neuen Behandlungsstatus an.

Wenn der Wert des felds ExceptionOption DEBUG_FILTER_REMOVE ist und der Ausnahmefilter ein beliebiger Ausnahmefilter ist, wird der Ausnahmefilter entfernt.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_OUTOFMEMORY	Die maximale Anzahl beliebiger Ausnahmefilter wurde überschritten.

Bemerkungen

Für jeden der Ausnahmefilterparameter in Params, wenn die Ausnahme, durch Ausnahmecode identifiziert, bereits einen Filter (spezifisch oder willkürlich) aufweist, wird dieser Filter geändert. Andernfalls wird ein neuer beliebiger Ausnahmefilter für die Ausnahme hinzugefügt.

Weitere Informationen zu Ereignisfilternfinden Sie unter Ereignisfilter.