Fonction RpcErrorClearInformation (rpcasync.h)

La fonction RpcErrorClearInformation efface toutes les informations d’erreur étendues sur le thread actif.

Syntaxe

void RpcErrorClearInformation();

Valeur de retour

Cette fonction n’a aucune valeur de retour.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

 

Remarques

Le runtime RPC gère généralement l’effacement des informations d’erreur étendues. Dans deux cas seulement, les appelants doivent utiliser RpcErrorClearInformation :

• Si le composant appelant ajoute des enregistrements au thread à l’aide de la fonction RpcErrorAddRecord , décide qu’il n’a pas rencontré d’erreur irrécupérable et continue à traiter l’original, ou que l’erreur n’est pas connectée aux enregistrements est ajoutée. Dans ce cas, le composant appelant doit effacer les informations d’erreur du thread pour empêcher la propagation d’informations d’erreur potentiellement trompeuses.
• Si le composant appelant tente plusieurs nouvelles tentatives d’une opération qui retourne des informations d’erreur étendues. Lorsqu’un appel RPC démarre, le runtime RPC efface toutes les informations d’erreur étendues sur le thread. Toutefois, si le composant appelant appelle RpcErrorAddRecord dans une boucle avec de nombreuses itérations, il peut vouloir effacer les informations d’erreur, car les informations d’erreur étendues s’accumulent au fil du temps et peuvent épuiser la mémoire disponible.

Configuration requise

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

Voir aussi

Obtention d’informations d’erreur RPC étendues

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration