RpcTestCancel, fonction (rpcdce.h)

La fonction RpcTestCancel recherche une indication d’annulation.

Syntaxe

RPC_STATUS RpcTestCancel();

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a été annulé.
Autres valeurs	L’appel n’a pas été annulé.

 

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

 

Il n’est pas rare que la fonction RpcTestCancel retourne la valeur ERROR_ACCESS_DENIED. Cela indique que l’appel de procédure distante n’a pas été annulé.

Remarques

Un stub du serveur d’applications appelle RpcTestCancel pour déterminer si un appel a été annulé. Si l’appel a été annulé, RPC_S_OK est retourné ; sinon, une autre valeur est retournée.

Cette fonction doit être appelée régulièrement par le stub du serveur afin qu’il puisse répondre aux annulations en temps opportun. Si la fonction retourne RPC_S_OK, le stub doit propre ses structures de données et revenir au client.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [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

RpcServerTestCancel