Fonction RpcBindingReset (rpcdce.h)

La fonction RpcBindingReset réinitialise un handle de liaison afin que l’hôte soit spécifié, mais que le serveur sur cet hôte ne soit pas spécifié.

Syntaxe

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

Paramètres

Binding

Handle de liaison de serveur à réinitialiser.

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_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

Un client appelle la fonction RpcBindingReset pour dissocier un serveur particulier instance du handle de liaison de serveur spécifié dans le paramètre Binding. La fonction RpcBindingReset dissocie un serveur instance en supprimant la partie point de terminaison de l’adresse du serveur dans le handle de liaison. L’hôte reste inchangé dans le handle de liaison. Le résultat est un handle de liaison de serveur partiellement lié.

RpcBindingReset n’affecte pas les informations d’authentification du paramètre Binding , le cas échéant.

Si un client est prêt à être pris en charge par n’importe quel serveur compatible instance sur l’hôte spécifié dans le handle de liaison, le client appelle la fonction RpcBindingReset avant d’effectuer un appel de procédure à distance à l’aide du handle de liaison de liaison. Les clients ne doivent pas appeler la fonction RpcBindingReset pour les handles de liaison sur lesquels les appels sont exécutés.

Lorsque le client effectue le prochain appel de procédure distante à l’aide de la liaison de réinitialisation (partiellement liée), la bibliothèque d’exécution RPC du client utilise un point de terminaison bien connu de la spécification d’interface du client, le cas échéant. Sinon, la bibliothèque d’exécution du client communique automatiquement avec le service de mappage de point de terminaison sur l’hôte distant spécifié pour obtenir le point de terminaison d’un serveur compatible à partir de la base de données endpoint-map. Si un serveur compatible se trouve, la bibliothèque d’exécution RPC met à jour la liaison avec un nouveau point de terminaison. Si un serveur compatible est introuvable, l’appel de procédure distante échoue. Pour les appels utilisant un protocole de connexion (ncacn), le code EPT_S_NOT_REGISTERED status est retourné au client. Pour les appels utilisant un protocole de datagramme (ncadg), le code RPC_S_COMM_FAILURE status est retourné au client.

Les applications serveur doivent inscrire tous les handles de liaison en appelant RpcEpRegister et RpcEpRegisterNoReplace si le serveur souhaite être disponible pour les clients qui effectuent un appel de procédure distante sur un handle de liaison de réinitialisation.

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

RpcEpRegister

RpcEpRegisterNoReplace