Fonction RpcStringBindingCompose (rpcdce.h)

  • Article

La fonction RpcStringBindingCompose crée un handle de liaison de chaîne.

Syntaxe

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Paramètres

ObjUuid

Pointeur vers une représentation de chaîne terminée par null d’un UUID d’objet. Par exemple, la chaîne 6B29FC40-CA47-1067-B31D-00DDD010662DA représente un UUID valide.

ProtSeq

Pointeur vers une représentation de chaîne terminée par null d’une séquence de protocole. Consultez Remarque.

NetworkAddr

Pointeur vers une représentation de chaîne terminée par null d’une adresse réseau. Le format d’adresse réseau est associé à la séquence de protocole. Consultez Remarque.

Endpoint

Pointeur vers une représentation de chaîne terminée par null d’un point de terminaison. Le format et le contenu du point de terminaison sont associés à la séquence de protocole. Par exemple, le point de terminaison associé à la séquence de protocole ncacn_np est un nom de canal au format \pipe\pipename. Consultez Remarque.

Options

Pointeur vers une représentation de chaîne terminée par null des options réseau. La chaîne d’option est associée à la séquence de protocole. Consultez Remarque.

StringBinding

Retourne un pointeur vers un pointeur vers une représentation de chaîne terminée par null d’un handle de liaison.

Spécifiez une valeur NULL pour empêcher RpcStringBindingCompose de renvoyer le paramètre StringBinding . Dans ce cas, l’application n’appelle pas RpcStringFree. Consultez Remarque.

Note Pour plus d’informations, consultez Liaison de chaînes.
 

Valeur retournée

Valeur Signification
RPC_S_OK
 L’appel a réussi.
RPC_S_INVALID_STRING_UUID
 La représentation sous forme de chaîne de l’UUID n’est pas valide.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

Remarques

Une application appelle la routine RpcStringBindingCompose pour combiner un UUID d’objet, une séquence de protocole, une adresse réseau, un point de terminaison et d’autres options réseau en une représentation sous forme de chaîne d’un handle de liaison.

La bibliothèque d’exécution RPC alloue de la mémoire pour la chaîne retournée dans le paramètre StringBinding . L’application est chargée d’appeler RpcStringFree pour libérer cette mémoire.

Spécifiez une valeur de paramètre null ou fournissez une chaîne vide (\0) pour chaque chaîne d’entrée qui ne contient aucune donnée.

Les caractères de barre oblique inverse littérale dans les chaînes en langage C doivent être entre guillemets. La chaîne C réelle pour le nom du serveur pour la séquence de protocole ncacn_np s’affiche sous la forme \\servername, et la chaîne C réelle pour un nom de canal apparaît sous la forme \pipe\pipename.

Configuration requise

Condition requise Valeur
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

Voir aussi

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree