Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
L’appel a été annulé par le client. Le serveur doit toujours terminer ou abandonner l’appel. |
|
Il n’y a pas d’appel actif sur le thread actif. |
|
L’appel n’a pas été annulé. |
|
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 |