RpcExceptionFilter-Funktion (rpcdce.h)

Artikel
03/01/2024

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