Fonction RpcMgmtSetCancelTimeout (rpcdce.h)

La fonction RpcMgmtSetCancelTimeout définit la limite inférieure du délai d’attente avant d’expirer après le transfert d’une annulation.

Syntaxe

RPC_STATUS RpcMgmtSetCancelTimeout(
  long Timeout
);

Paramètres

Timeout

Quelques secondes avant qu’un serveur accuse réception d’une commande cancel. Pour spécifier qu’un client attend une durée indéfinie, fournissez la valeur RPC_C_CANCEL_INFINITE_TIMEOUT.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_CANNOT_SUPPORT	Appelé à partir d’un MS-DOS ou windows 3. x client.

 

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

 

Remarques

Une application appelle la fonction RpcMgmtSetCancelTimeout pour réinitialiser la durée pendant laquelle la bibliothèque d’exécution attend qu’un serveur accuse réception d’une annulation. L’application spécifie d’attendre indéfiniment ou d’attendre une durée spécifiée en secondes. Si la valeur seconds est 0 (zéro), l’appel est immédiatement abandonné lors d’une commande d’annulation et le contrôle retourne à l’application cliente. La valeur par défaut est RPC_C_CANCEL_INFINITE_TIMEOUT, qui spécifie l’attente indéfinie de la fin de l’appel.

La valeur du délai d’expiration de la commande cancel s’applique à tous les appels de procédure distante effectués dans le thread actuel. Pour modifier la valeur du délai d’attente, un client multithread doit appeler cette fonction dans chaque thread d’exécution.

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