Fonction RpcStringBindingComposeW (rpcdce.h)
La fonction RpcStringBindingCompose crée un handle de liaison de chaîne.
Syntaxe
RPC_STATUS RpcStringBindingComposeW(
RPC_WSTR ObjUuid,
RPC_WSTR ProtSeq,
RPC_WSTR NetworkAddr,
RPC_WSTR Endpoint,
RPC_WSTR Options,
RPC_WSTR *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.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
La représentation sous forme de chaîne de l’UUID n’est pas valide. |
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.
Notes
L’en-tête rpcdce.h définit RpcStringBindingCompose comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 |