RpcStringBindingParse, 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 RpcStringBindingParse(
  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
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_STRING_BINDING	Liaison de chaîne non valide.

 

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

 

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.

Note 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 de la liaison de chaîne.

 

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

RpcStringBindingCompose

RpcStringFree