Fonction RpcBindingCopy (rpcdce.h)

Article
08/25/2023

La fonction RpcBindingCopy copie les informations de liaison et crée un nouveau handle de liaison.

Syntaxe

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Paramètres

SourceBinding

Handle de liaison de serveur dont les informations de liaison référencées sont copiées.

DestinationBinding

Retourne un pointeur vers le handle de liaison de serveur qui fait référence aux informations de liaison copiées.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

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

Remarques

La fonction RpcBindingCopy copie les informations de liaison de serveur référencées par le paramètre SourceBinding . RpcBindingCopy utilise le paramètre DestinationBinding pour renvoyer un nouveau handle de liaison de serveur pour les informations de liaison copiées. RpcBindingCopy copie également les informations d’authentification du paramètre SourceBinding vers le paramètre DestinationBinding .

Une application utilise RpcBindingCopy lorsqu’elle souhaite empêcher qu’une modification apportée aux informations de liaison par un thread n’affecte les informations de liaison utilisées par d’autres threads.

Une fois qu’une application appelle RpcBindingCopy, les opérations effectuées sur le handle de liaison SourceBinding n’affectent pas les informations de liaison référencées par le handle de liaison DestinationBinding . De même, les opérations effectuées sur le handle de liaison DestinationBinding n’affectent pas les informations de liaison référencées par le handle de liaison SourceBinding .

Si une application souhaite que les modifications apportées par un thread aux informations de liaison affectent les informations de liaison utilisées par d’autres threads, l’application doit partager un seul handle de liaison entre les threads. Dans ce cas, l’application est responsable du contrôle de concurrence binding-handle.

Lorsqu’une application a terminé d’utiliser le handle de liaison spécifié par le paramètre DestinationBinding , l’application doit appeler la fonction RpcBindingFree pour libérer la mémoire utilisée par le handle de liaison DestinationBinding et ses informations de liaison référencées.

Note Microsoft RPC prend en charge RpcBindingCopy uniquement dans les applications clientes, pas dans les applications serveur.

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

RpcBindingFree

Partager via