RPC_BINDING_HANDLE_TEMPLATE_V1_W structure (rpcdce.h)

Article
08/25/2023

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_W {
  unsigned long  Version;
  unsigned long  Flags;
  unsigned long  ProtocolSequence;
  unsigned short *NetworkAddress;
  unsigned short *StringEndpoint;
  union {
    unsigned short *Reserved;
  } u1;
  UUID           ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_W, *PRPC_BINDING_HANDLE_TEMPLATE_V1_W;

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

Littéral de chaîne de séquence de protocole associé à ce handle de liaison. Il peut avoir l’une des valeurs suivantes.

ncalrpc : spécifie rpc local. ncacn_ip_tcp : spécifie RPC sur TCP/IP. ncacn_np : spécifie RPC sur les canaux nommés. ncacn_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