RpcExceptionFilter, fonction (rpcdce.h)

Article
03/01/2024

La fonction RpcExceptionFilter est un filtre d’exception par défaut qui détermine si une exception est irrécupérable ou non irrécupérable. RpcExceptionFilter est recommandé pour la gestion structurée des exceptions pour les exceptions les plus courantes en guise d’alternative aux filtres personnalisés avec RpcExcept.

Syntaxe

int RpcExceptionFilter(
  [in] unsigned long ExceptionCode
);

Paramètres

[in] ExceptionCode

Valeur d’une exception. L’une des valeurs d’exception suivantes retourne EXCEPTION_CONTINUE_SEARCH :

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

Valeur retournée

Valeur qui spécifie si l’exception a été fatale ou non mortelle.

Code de retour	Description
EXCEPTION_CONTINUE_SEARCH	L’exception est irrécupérable et doit être gérée.
EXCEPTION_EXECUTE_HANDLER	L’exception n’est pas fatale.

Remarques

L’utilisation recommandée de RpcExceptionFilter est la suivante :


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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

Gestion des exceptions

RpcExcept

RpcExceptionCode

RpcTryExcept

Partager via