Fonction RpcBindingFromStringBinding (rpcdce.h)

  • Article

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 RpcBindingFromStringBinding(
  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.

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