Fonction RpcNsBindingSelect (rpcnsi.h)

  • Article

La fonction RpcNsBindingSelect retourne un handle de liaison à partir d’une liste de handles de liaison compatibles.

Note Cette fonction n’est pas prise en charge sur Windows Vista et les systèmes d’exploitation ultérieurs.
 

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
RPC_S_OK
 L’appel a réussi.
RPC_S_NO_MORE_BINDINGS
 Plus de liaisons.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

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

Voir aussi

RpcBindingFree

RpcNsBindingLookupNext

RpcStringBindingParse

select