Fonction RpcBindingFromStringBindingA (rpcdce.h)

La fonction RpcBindingFromStringBinding retourne un handle de liaison à partir d’une représentation sous forme de chaîne d’un handle de liaison.

Syntaxe

RPC_STATUS RpcBindingFromStringBindingA(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Paramètres

StringBinding

Pointeur vers une représentation sous forme de chaîne d’un handle de liaison.

Binding

Retourne un pointeur vers le handle de liaison de serveur.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_STRING_BINDING	La liaison de chaîne n’est pas valide.
RPC_S_PROTSEQ_NOT_SUPPORTED	Séquence de protocole non prise en charge sur cet hôte.
RPC_S_INVALID_RPC_PROTSEQ	La séquence de protocole n’est pas valide.
RPC_S_INVALID_ENDPOINT_FORMAT	Le format du point de terminaison n’est pas valide.
RPC_S_STRING_TOO_LONG	Chaîne trop longue.
RPC_S_INVALID_NET_ADDR	L’adresse réseau n’est pas valide.
RPC_S_INVALID_ARG	L’argument n’était pas valide.
RPC_S_INVALID_NAF_ID	L’identificateur de famille d’adresses réseau n’est pas valide.

 

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

 

Remarques

La fonction RpcBindingFromStringBinding crée un handle de liaison de serveur à partir d’une représentation sous forme de chaîne d’un handle de liaison. Le paramètre StringBinding n’a pas besoin de contenir un UUID d’objet. Dans ce cas, la liaison retournée contient un UUID nul. Si le paramètre StringBinding fourni ne contient pas de champ de point de terminaison, le paramètre Binding retourné est un handle de liaison partiellement lié. Si le paramètre StringBinding fourni contient un champ de point de terminaison, le point de terminaison est considéré comme un point de terminaison connu. Si le paramètre StringBinding fourni ne contient pas de champ d’adresse de l’hôte, le paramètre Binding retourné fait référence à l’hôte local.

Une application crée une liaison de chaîne en appelant la fonction RpcStringBindingCompose ou en fournissant une constante de chaîne de caractères. La création d’une liaison de chaîne par cette méthode n’implique pas de contact avec le serveur. La réussite ou l’échec de l’API n’indique pas la disponibilité du serveur.

Lorsqu’une application a terminé d’utiliser le paramètre Binding , l’application doit appeler la fonction RpcBindingFree pour libérer la mémoire utilisée par le handle de liaison.

Notes

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

Voir aussi

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose