Fonction RpcServerTestCancel (rpcdce.h)

Article
03/01/2024

Le serveur appelle RpcServerTestCancel pour tester les demandes d’annulation du client.

Syntaxe

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

Paramètres

BindingHandle

Appel pour tester les commandes d’annulation. Si la valeur zéro est spécifiée, le serveur emprunte l’identité du client pris en charge par ce thread de serveur.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a été annulé par le client. Le serveur doit toujours terminer ou abandonner l’appel.
RPC_S_NO_CALL_ACTIVE	Il n’y a pas d’appel actif sur le thread actif.
RPC_S_CALL_IN_PROGRESS	L’appel n’a pas été annulé.
RPC_S_INVALID_BINDING	Le handle n’est pas valide.

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

Remarques

Le serveur appelle RpcServerTestCancel pour savoir si le client a demandé l’annulation d’un appel en attente. La fonction RpcServerTestCancel indique uniquement si un client a annulé l’appel ; l’état n’est pas modifié sur le serveur ou le client. L’appel annulé doit toujours être terminé ou abandonné par le serveur RPC, à l’aide des appels de fonction RpcAsyncCompleteCall ou RpcAsyncAbortCall , respectivement.

Le paramètre BindingHandle spécifie l’appel sur lequel tester. Si le paramètre a la valeur zéro, l’appel sur le thread actuel est testé. Le serveur peut appeler la fonction RpcServerTestCancel(RpcAsyncGetCallHandle(pAsync)) pour tester un message d’annulation à l’aide du handle asynchrone pour obtenir le handle de liaison.

Configuration requise

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