RpcEpResolveBinding, fonction (rpcdce.h)

Article
08/25/2023

La fonction RpcEpResolveBinding résout un handle de liaison de serveur partiellement lié en un handle de liaison de serveur entièrement lié.

Syntaxe

RPC_STATUS RpcEpResolveBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_HANDLE      IfSpec
);

Paramètres

Binding

Handle de liaison de serveur partiellement lié à résoudre en handle de liaison de serveur entièrement lié.

IfSpec

Structure générée par stub spécifiant l’interface d’intérêt.

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

Une application appelle la fonction RpcEpResolveBinding pour résoudre un handle de liaison de serveur partiellement lié en un handle de liaison entièrement lié.

La résolution des handles de liaison nécessite un UUID d’interface et un UUID d’objet (qui peut être nul). La bibliothèque d’exécution RPC demande au service de mappage de point de terminaison sur l’hôte spécifié par le paramètre Binding de rechercher un point de terminaison pour un serveur compatible instance. Pour trouver le point de terminaison, le service de mappage de point de terminaison recherche dans la base de données endpoint-map l’UUID d’interface dans le paramètre IfSpec et l’UUID de l’objet dans le paramètre Binding , le cas échéant.

Le fonctionnement de l’opération de résolution de liaison varie selon que le handle de liaison spécifié est partiellement ou entièrement lié. Lorsque le client spécifie un handle partiellement lié, l’opération de résolution de liaison a les résultats possibles suivants :

Si aucune instance de serveur compatible n’est inscrite dans la base de données endpoint-map, l’opération de liaison de résolution retourne le code EPT_S_NOT_REGISTERED status.
Si un serveur compatible instance est inscrit dans la base de données endpoint-map, l’opération resolve-binding retourne une liaison entièrement liée et le code RPC_S_OK status.

Lorsque le client spécifie un handle de liaison entièrement lié, l’opération de résolution-liaison retourne le handle de liaison spécifié et le code RPC_S_OK status. L’opération de résolution de liaison ne contacte pas le service de mappage de point de terminaison.

Dans le cas de liaison partiellement ou entièrement liée, l’opération de liaison de résolution ne contacte pas un serveur compatible instance.

Note L’appel de RpcEpResolveBinding n’est pas strictement nécessaire. Si un appel RPC est effectué sur un handle de liaison de serveur partiellement lié, le temps d’exécution RPC prend les mesures nécessaires pour faire de la liaison un handle de liaison entièrement lié. L’exécution rpc appelle RpcEpResolveBinding, mais le fait plus efficacement en raison de techniques de mise en cache supplémentaires. Dans Windows XP et Windows 2000, les applications n’ont aucune raison d’appeler RpcEpResolveBinding.

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