RpcAsyncAbortCall, fonction (rpcasync.h)

Article
08/25/2023

Le serveur appelle RpcAsyncAbortCall pour abandonner un appel asynchrone.

Syntaxe

RPC_STATUS RpcAsyncAbortCall(
  PRPC_ASYNC_STATE pAsync,
  unsigned long    ExceptionCode
);

Paramètres

pAsync

Pointeur vers la structure RPC_ASYNC_STATE qui contient des informations d’appel asynchrones.

ExceptionCode

Code d’exception différent de zéro spécifique à l’application. Il peut s’agir d’un code d’erreur défini par l’application ou d’un code d’erreur RPC standard. Pour plus d’informations, consultez Valeurs de retour RPC.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’annulation de l’appel a réussi.
RPC_S_INVALID_ASYNC_HANDLE	Le handle asynchrone n’est pas valide.

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

Notes

Le serveur appelle RpcAsyncAbortCall lorsque des circonstances l’obligent à abandonner un appel asynchrone avant la fin. Par exemple, l’appelant n’a peut-être pas les autorisations nécessaires pour effectuer la demande, ou le serveur peut être trop occupé pour traiter l’appel. Utilisez le paramètre ExceptionCode pour spécifier la raison de l’abandon. L’environnement d’exécution propage le code d’exception au client en tant qu’erreur.

Lorsqu’un appel asynchrone est abandonné avec RpcAsyncAbortCall, aucun marshaling des arguments de sortie n’est effectué et tous les arguments d’entrée sont libérés par RPC. Lorsque RpcAsyncAbortCall est appelé, un appel à la fonction RpcAsyncCompleteCall n’est pas nécessaire. La fonction RpcAsyncAbortCall ne doit être appelée qu’une seule fois pour tout appel asynchrone ; un deuxième appel peut bloquer le processus ou échouer d’autres manières inattendues.

Spécifications


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	rpcasync.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll