Fonction RpcStringBindingParseW (rpcdce.h)
La fonction RpcStringBindingParse retourne la partie UUID de l’objet et les parties d’adresse d’une liaison de chaîne sous forme de chaînes distinctes. Une application appelle RpcStringBindingParse pour analyser une représentation sous forme de chaîne d’un handle de liaison dans ses champs de composant. La fonction RpcStringBindingParse retourne la partie UUID de l’objet et les parties d’adresse d’une liaison de chaîne sous forme de chaînes distinctes.
Syntaxe
RPC_STATUS RpcStringBindingParseW(
RPC_WSTR StringBinding,
RPC_WSTR *ObjUuid,
RPC_WSTR *Protseq,
RPC_WSTR *NetworkAddr,
RPC_WSTR *Endpoint,
RPC_WSTR *NetworkOptions
);
Paramètres
StringBinding
Pointeur vers une représentation de chaîne terminée par null d’une liaison.
ObjUuid
Retourne un pointeur vers un pointeur vers une représentation de chaîne terminée par null d’un UUID d’objet.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de renvoyer le paramètre ObjectUuid . Dans ce cas, l’application n’appelle pas RpcStringFree.
Protseq
Retourne un pointeur vers un pointeur vers une représentation de chaîne terminée par null d’une séquence de protocole. Pour obtenir la liste des séquences de protocoles prises en charge par Microsoft RPC, consultez Liaison de chaînes.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de renvoyer le paramètre ProtSeq . Dans ce cas, l’application n’appelle pas RpcStringFree.
NetworkAddr
Retourne un pointeur vers un pointeur vers une représentation de chaîne terminée par null d’une adresse réseau. Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de renvoyer le paramètre NetworkAddr . Dans ce cas, l’application n’appelle pas RpcStringFree.
Endpoint
Retourne un pointeur vers un pointeur vers une représentation de chaîne terminée par null d’un point de terminaison. Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de renvoyer le paramètre EndPoint . Dans ce cas, l’application n’appelle pas RpcStringFree.
NetworkOptions
Retourne un pointeur vers un pointeur vers une représentation sous forme de chaîne null d’options réseau.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de renvoyer le paramètre NetworkOptions . Dans ce cas, l’application n’appelle pas RpcStringFree.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
Liaison de chaîne non valide. |
Remarques
Une application appelle la routine RpcStringBindingParse pour analyser une représentation sous forme de chaîne d’un handle de liaison dans ses champs de composant.
La bibliothèque d’exécution RPC alloue de la mémoire pour chaque chaîne de composant retournée. L’application est chargée d’appeler RpcStringFree une fois pour chaque chaîne retournée afin de libérer la mémoire de cette chaîne.
Si un champ du paramètre StringBinding est vide, RpcStringBindingParse retourne une chaîne vide (\0) dans le paramètre de sortie correspondant.
Notes
L’en-tête rpcdce.h définit RpcStringBindingParse 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 |