Fonction RpcNsBindingSelect (rpcnsi.h)
La fonction RpcNsBindingSelect retourne un handle de liaison à partir d’une liste de handles de liaison compatibles.
Syntaxe
RPC_STATUS RpcNsBindingSelect(
RPC_BINDING_VECTOR *BindingVec,
RPC_BINDING_HANDLE *Binding
);
Paramètres
BindingVec
Pointeur vers le vecteur des handles de liaison de serveur compatibles avec le client à partir desquels un handle de liaison est sélectionné. Le vecteur de liaison retourné ne fait plus référence au handle de liaison sélectionné, qui est retourné séparément dans le paramètre Binding .
Binding
Pointeur vers un handle de liaison sélectionné.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
Plus de liaisons. |
Remarques
Chaque fois que le client appelle la fonction RpcNsBindingSelect , l’opération de fonction retourne un autre handle de liaison à partir du vecteur.
Lorsque tous les handles de liaison ont été retournés à partir du vecteur, la fonction retourne une status de RPC_S_NO_MORE_BINDINGS et retourne une valeur de liaisonnull.
L’opération select alloue le stockage pour les données référencées par le paramètre Binding retourné. Lorsqu’un client termine avec le handle de liaison, il doit appeler la fonction RpcBindingFree pour libérer le stockage. Chaque appel à RpcNsBindingSelect nécessite un appel correspondant à la fonction RpcBindingFree .
Les clients peuvent créer leurs propres routines de sélection implémentant des critères de sélection spécifiques à l’application. Dans ce cas, RpcStringBindingParse permet d’accéder aux champs d’une liaison.
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 | rpcnsi.h (inclure Rpc.h) |
| Bibliothèque | Rpcns4.lib |
| DLL | Rpcns4.dll |