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

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

Voir aussi

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose