IDebugControl2::SetExceptionFilterParameters-Methode (dbgeng.h)

Artikel
02/29/2024

Die SetExceptionFilterParameters-Methode ändert den Umbruch status und die Behandlung status 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_PARAMETERS an. Nur die Felder ExecutionOption, ContinueOption und ExceptionCode dieser Parameter werden verwendet. Das Feld ExceptionCode wird verwendet, um die Ausnahme zu identifizieren, deren Ausnahmefilter geändert wird. ExceptionOption gibt den neuen Umbruch status an, und ContinueOption gibt die neue Status 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.

Hinweise

Wenn die durch Ausnahmecode identifizierte Ausnahme für jeden Ausnahmefilterparameter in Params bereits über einen Filter (spezifisch oder willkürlich) verfügt, wird dieser Filter geändert. Andernfalls wird für die Ausnahme ein neuer beliebiger Ausnahmefilter hinzugefügt.

Weitere Informationen zu Ereignisfiltern finden Sie unter Ereignisfilter.