RPC_BINDING_HANDLE_TEMPLATE_V1_A structure (rpcdce.h)

Article
03/04/2024

La structure RPC_BINDING_HANDLE_TEMPLATE_V1 contient les options de base avec lesquelles créer un handle de liaison RPC.

Syntaxe

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_A {
  unsigned long Version;
  unsigned long Flags;
  unsigned long ProtocolSequence;
  unsigned char *NetworkAddress;
  unsigned char *StringEndpoint;
  union {
    unsigned char *Reserved;
  } u1;
  UUID          ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_A, *PRPC_BINDING_HANDLE_TEMPLATE_V1_A;

Membres

Version

Version de cette structure. Pour RPC_BINDING_HANDLE_TEMPLATE_V1 cette valeur doit être définie sur 1.

Flags

Valeurs d’indicateur qui décrivent des propriétés spécifiques du modèle RPC.

Valeur	Signification
RPC_BHT_OBJECT_UUID_VALID	Le membre ObjectUuid contient une valeur valide. Si cet indicateur n’est pas défini, le membre ObjectUuid ne contient pas d’UUID valide.

ProtocolSequence

ID de séquence de protocole associé à ce handle de liaison. Il peut avoir l’une des valeurs suivantes.

RPC_PROTSEQ_LRPC : spécifie le RPC local.
RPC_PROTSEQ_TCP : spécifie RPC sur TCP/IP.
RPC_PROTSEQ_NMP : spécifie RPC sur les canaux nommés.
RPC_PROTSEQ_HTTP : spécifie RPC sur HTTP.

NetworkAddress

Pointeur vers une représentation sous forme de chaîne de l’adresse réseau à lier.

StringEndpoint

Pointeur vers une représentation sous forme de chaîne du point de terminaison à lier. Si un point de terminaison dynamique est utilisé, définissez ce membre sur NULL. Une fois le point de terminaison résolu, utilisez RpcBindingToStringBinding pour l’obtenir.

u1

u1.Reserved

Réservé. Ce membre doit être défini sur NULL.

ObjectUuid

UUID de l’objet distant. La sémantique de cet UUID est identique à celle d’une liaison de chaîne. Une fois le handle de liaison créé, appelez RpcBindingSetObject pour modifier l’UUID en fonction des besoins.

Remarques

Les poignées de liaison rapide sont légèrement différentes des poignées de liaison « classiques » dans la façon dont elles sont gérées lors des appels à RpcBindingReset. RpcBindingReset est un appel sans opération pour les handles de liaison rapide statiques. Toutefois, pour les handles de liaison classiques, RpcBindingReset convertit un handle de liaison statique en handle dynamique pour préserver la compatibilité descendante.

Le tableau suivant illustre le comportement des handles de liaison statiques et dynamiques en ce qui concerne RpcBindingReset et RpcEpResolveBinding.

Type de point de terminaison	statique		Dynamique
Type de handle de liaison	Rapide	Classique	Rapide	Classique
RpcBindingReset	Aucune opération	Convertit en dynamique	Supprime le point de terminaison résolu s’il y en a un	Supprime le point de terminaison résolu s’il y en a un
RpcEpResolveBinding	Aucune opération	Aucune opération	Résout le point de terminaison s’il n’est pas résolu précédemment	Résout le point de terminaison s’il n’est pas résolu précédemment

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	rpcdce.h (inclure Rpc.h)

Voir aussi

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate

Partager via