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 |