RpcServerInqBindings, fonction (rpcdce.h)

Article
08/25/2023

La fonction RpcServerInqBindings retourne les handles de liaison sur lesquels les appels de procédure distante peuvent être reçus.

Syntaxe

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

Paramètres

BindingVector

Retourne un pointeur vers un vecteur de handles de liaison de serveur.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_NO_BINDINGS	Aucune liaison.

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

Remarques

Une application serveur appelle RpcServerInqBindings pour obtenir un vecteur de handles de liaison de serveur. La bibliothèque d’exécution RPC crée des handles de liaison lorsqu’une application serveur appelle les fonctions suivantes pour inscrire des séquences de protocole :

Le vecteur de liaison retourné peut contenir des handles de liaison avec des points de terminaison dynamiques ou des handles de liaison avec des points de terminaison connus, selon les fonctions ci-dessus que l’application serveur a appelées.

Un serveur utilise le vecteur des handles de liaison pour l’exportation vers le service de noms, pour l’inscription auprès de la base de données de mappage de points de terminaison locale ou pour la conversion en liaisons de chaîne. S’il n’existe aucun handle de liaison (aucune séquence de protocole inscrite), cette routine retourne le code RPC_S_NO_BINDINGS status et une valeur de paramètre BindingVector null. Le serveur est chargé d’appeler la fonction RpcBindingVectorFree pour libérer la mémoire utilisée par le vecteur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll