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 sous forme de chaînenull -terminated string d’une liaison.

ObjUuid

Retourne un pointeur vers un pointeur vers une représentation sous forme de chaîne null-terminated d’un objet UUID.

Spécifiez une valeur de 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 null-terminated string 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 de 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 null-terminated string d’une adresse réseau. Spécifiez une valeur de 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 null-terminated string 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-terminated string des options réseau.

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

Valeur de retour

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_STRING_BINDING	La liaison de chaîne n’est pas valide.

 

Remarque Pour obtenir la liste des codes d’erreur valides, consultez valeurs de retour RPC.

 

Remarques

Une application appelle RpcStringBindingParse routine 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.

Remarque Pour interroger l’adresse d’un client, une application commence par appeler la fonction RpcBindingServerFromClient pour obtenir un handle de liaison de serveur partiellement lié. Le handle de liaison de serveur peut être utilisé pour obtenir une liaison de chaîne en appelant RpcBindingToStringBinding. Le serveur peut ensuite appeler RpcStringBindingParse pour extraire l’adresse réseau du client à partir de la liaison de chaîne.

 

Note

L’en-tête rpcdce.h définit RpcStringBindingParse comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
plateforme cible	Windows
d’en-tête	rpcdce.h (inclure Rpc.h)
bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

RpcBindingFromStringBinding

RpcBindingToStringBinding

rpcStringBindingCompose

rpcStringFree