RpcBindingFromStringBindingA, fonction (rpcdce.h)

Article
11/20/2024

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 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.
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 de 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.

Remarque 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 ne doit pas contenir d’objet UUID. Dans ce cas, la liaison retournée contient un UUID nil. Si le paramètre de 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 de 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 de StringBinding fourni ne contient pas de champ d’adresse hôte, le paramètre de liaison 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 est terminée à l’aide du paramètre Binding, l’application doit appeler la fonction RpcBindingFree pour libérer la mémoire utilisée par le handle de liaison.

Note

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

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

rpcStringBindingCompose

Partager via