Partager via


RpcServerInterfaceGroupInqBindings, fonction (rpcdce.h)

La fonction RpcServerInterfaceGroupInqBindings retourne les handles de liaison sur lesquels les appels de procédure distante peuvent être reçus pour le groupe d’interfaces donné.

Syntaxe

RPC_STATUS RpcServerInterfaceGroupInqBindings(
  [in]  RPC_INTERFACE_GROUP IfGroup,
  [out] RPC_BINDING_VECTOR  **BindingVector
);

Paramètres

[in] IfGroup

Une RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate qui définit le groupe d’interfaces pour lequel les liaisons doivent être interrogées.

[out] 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 RpcServerInterfaceGroupInqBindings pour obtenir un vecteur de handles de liaison de serveur pour le groupe d’interfaces donné. La bibliothèque d’exécution RPC crée des handles de liaison pour un groupe d’interfaces lorsqu’une application serveur appelle la fonction RpcServerInterfaceGroupActivate .

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, en fonction de la spécification du point de terminaison du groupe d’interfaces.

Un serveur utilise le vecteur des handles de liaison pour l’exportation vers le service de noms ou pour la conversion en liaisons de chaîne. S’il n’existe aucun handle de liaison (aucune séquence de protocole inscrite), RpcServerInterfaceGroupInqBindings retourne RPC_S_NO_BINDINGS et BindingVector a la valeur NULL. Le serveur est chargé d’appeler RpcBindingVectorFree pour libérer la mémoire du vecteur.

Configuration requise

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

Voir aussi

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate