RpcStringBindingParseA, fonction (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 RpcStringBindingParseA(
RPC_CSTR StringBinding,
RPC_CSTR *ObjUuid,
RPC_CSTR *Protseq,
RPC_CSTR *NetworkAddr,
RPC_CSTR *Endpoint,
RPC_CSTR *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 sous forme de chaîne terminée par une valeur Null d’un UUID d’objet.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de retourner le paramètre ObjectUuid . Dans ce cas, l’application n’appelle pas RpcStringFree.
Protseq
Retourne un pointeur vers un pointeur vers une représentation sous forme de chaîne terminée par un caractère Null d’une séquence de protocole. Pour obtenir la liste des séquences de protocole prises en charge par Microsoft RPC, consultez Liaison de chaîne.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de retourner le paramètre ProtSeq . Dans ce cas, l’application n’appelle pas RpcStringFree.
NetworkAddr
Retourne un pointeur vers un pointeur vers une représentation sous forme de chaîne terminée par null d’une adresse réseau. Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de retourner le paramètre NetworkAddr . Dans ce cas, l’application n’appelle pas RpcStringFree.
Endpoint
Retourne un pointeur vers un pointeur vers une représentation sous forme de chaîne terminée par une valeur Null d’un point de terminaison. Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de retourner 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 terminée par un caractère Null des options réseau.
Spécifiez une valeur NULL pour empêcher RpcStringBindingParse de retourner 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 en tant qu’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. La combinaison 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 |