Partager via


Fonction RpcServerTestCancel (rpcdce.h)

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

Voir aussi

RPC asynchrone

RPC_ASYNC_STATE

RpcAsyncAbortCall

RpcAsyncCancelCall

RpcAsyncCompleteCall

RpcAsyncGetCallHandle

RpcAsyncGetCallStatus

RpcAsyncInitializeHandle