RpcMgmtSetComTimeout, fonction (rpcdce.h)

Article
08/25/2023

La fonction RpcMgmtSetComTimeout définit la valeur de délai d’expiration des communications de liaison dans un handle de liaison.

Syntaxe

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

Paramètres

Binding

Handle de liaison de serveur dont la valeur de délai d’attente est définie.

Timeout

Valeur du délai d’attente des communications, comprise entre zéro et 10. Ces valeurs ne sont pas des secondes ; ils représentent une durée relative sur une échelle de zéro à 10.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_INVALID_TIMEOUT	La valeur du délai d’attente n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

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

Notes

Dans Windows XP et Windows 2000, pendant la liaison, le temps d’exécution RPC utilise le plus court délai d’expiration des appels de 15 minutes et le délai d’attente défini à l’aide de la fonction RpcMgmtSetComTimeout . Dans les échanges après la liaison, l’exécution rpc utilise uniquement le délai d’attente défini dans à l’aide de la fonction RpcMgmtSetComTimeout . Cette option est ignorée pour les séquences de protocole ncalrpc et ncadg_* .

Une application cliente appelle RpcMgmtSetComTimeout pour modifier la valeur du délai d’attente des communications pour un handle de liaison de serveur. Selon la séquence de protocole pour le handle de liaison spécifié, la valeur de délai d’attente agit uniquement en tant qu’indicateur pour la bibliothèque d’exécution RPC. Chaque séquence de protocole interprète ce paramètre différemment ; pour ncacn_ip_tcp, la valeur est utilisée pour activer les keep-alives pour tous les appels. Par exemple, pour ncacn_ip_tcp, la définition du délai d’expiration sur zéro indique à RPC d’activer les keep-alives si une réponse n’est pas reçue en 60 secondes (l’intervalle de 60 secondes est spécifique à l’implémentation et susceptible d’être modifié). Dans ce cas, l’appel client n’est pas expiré tant que le serveur est en cours d’exécution ; Toutefois, si le serveur échoue ou perd son adresse IP, RPC échoue à l’appel. L’indicateur de délai d’attente TCP est utilisé pendant l’établissement de la connexion, ainsi que pendant les échanges de demandes/réponses.

Note L’utilisation de l’indicateur de délai d’attente TCP est la meilleure pratique pour détecter les serveurs défaillants.

Dans Windows XP, les maintiens en vie d’une connexion donnée sont désactivés lorsque le serveur répond.

Pour des raisons pratiques, des constantes sont fournies pour certaines valeurs dans la plage de délai d’attente. Pour obtenir la liste des valeurs définies par RPC qu’une application peut utiliser pour l’argument de délai d’attente, consultez Liaison des constantes de délai d’attente.

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

Voir aussi

RpcMgmtInqComTimeout

Partager via