RpcExceptionFilter-Funktion (rpcdce.h)

Die RpcExceptionFilter-Funktion ist ein Standardausnahmefilter, der bestimmt, ob eine Ausnahme fatal oder nicht tödlich ist. RpcExceptionFilter wird für die strukturierte Ausnahmebehandlung für die häufigsten Ausnahmen als Alternative zu benutzerdefinierten Filtern mit RpcExcept empfohlen.

Syntax

int RpcExceptionFilter(
  [in] unsigned long ExceptionCode
);

Parameter

[in] ExceptionCode

Wert einer Ausnahme. Einer der folgenden Ausnahmewerte gibt EXCEPTION_CONTINUE_SEARCH zurück:

STATUS_ACCESS_VIOLATION

STATUS_POSSIBLE_DEADLOCK

STATUS_INSTRUCTION_MISALIGNMENT

STATUS_DATATYPE_MISALIGNMENT

STATUS_PRIVILEGED_INSTRUCTION

STATUS_ILLEGAL_INSTRUCTION

STATUS_BREAKPOINT

STATUS_STACK_OVERFLOW

STATUS_HANDLE_NOT_CLOSABLE

STATUS_IN_PAGE_ERROR

STATUS_ASSERTION_FAILURE

STATUS_STACK_BUFFER_OVERRUN

STATUS_GUARD_PAGE_VIOLATION

STATUS_REG_NAT_CONSUMPTION

Rückgabewert

Ein Wert, der angibt, ob die Ausnahme fatal oder nicht tödlich war.

Rückgabecode Beschreibung
EXCEPTION_CONTINUE_SEARCH
Die Ausnahme ist fatal und muss behandelt werden.
EXCEPTION_EXECUTE_HANDLER
Die Ausnahme ist nicht fatal.

Hinweise

Die empfohlene Verwendung von RpcExceptionFilter lautet:


RpcTry
{
    … RPC calls here …
RpcExcept(RpcExceptionFilter(RpcExceptionCode()))
{
    … error handling here …
}
RpcEndExcept

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcdce.h (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Ausnahmebehandlung

RpcExcept

RpcExceptionCode

RpcTryExcept