estructura RPC_BINDING_HANDLE_TEMPLATE_V1_A (rpcdce.h)

  • Artículo

La estructura RPC_BINDING_HANDLE_TEMPLATE_V1 contiene las opciones básicas con las que crear un identificador de enlace RPC.

Sintaxis

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;

Miembros

Version

Versión de esta estructura. Para RPC_BINDING_HANDLE_TEMPLATE_V1 debe establecerse en 1.

Flags

Marca los valores que describen propiedades específicas de la plantilla RPC.

Valor Significado
RPC_BHT_OBJECT_UUID_VALID
 El miembro ObjectUuid contiene un valor válido. Si no se establece esta marca, el miembro ObjectUuid no contiene un UUID válido.

ProtocolSequence

Identificador de secuencia de protocolo asociado a este identificador de enlace. Puede ser uno de los siguientes valores.

  • RPC_PROTSEQ_LRPC : especifica rpc local.
  • RPC_PROTSEQ_TCP : especifica RPC a través de TCP/IP.
  • RPC_PROTSEQ_NMP : especifica RPC sobre canalizaciones con nombre.
  • RPC_PROTSEQ_HTTP : especifica RPC a través de HTTP.

NetworkAddress

Puntero a una representación de cadena de la dirección de red a la que se va a enlazar.

StringEndpoint

Puntero a una representación de cadena del punto de conexión al que se va a enlazar. Si se usa un punto de conexión dinámico, establezca este miembro en NULL. Una vez resuelto el punto de conexión, use RpcBindingToStringBinding para obtenerlo.

u1

u1.Reserved

Reservado. Este miembro debe establecerse en NULL.

ObjectUuid

UUID del objeto remoto. La semántica de este UUID es la misma que la de un enlace de cadena. Una vez creado el identificador de enlace, llame a RpcBindingSetObject para cambiar el UUID según sea necesario.

Comentarios

Los identificadores de enlace rápidos son ligeramente diferentes de los identificadores de enlace "clásicos" de la forma en que se controlan durante las llamadas a RpcBindingReset. RpcBindingReset es una llamada sin operación para identificadores de enlace rápido estáticos. Sin embargo, para los identificadores de enlace clásicos, RpcBindingReset convierte un identificador de enlace estático en uno dinámico para conservar la compatibilidad con versiones anteriores.

En la tabla siguiente se muestra el comportamiento de los controladores de enlace estáticos y dinámicos con respecto a RpcBindingReset y RpcEpResolveBinding.

Tipo de punto de conexión Estático Dinámica
Tipo de identificador de enlace Rápido Clásico Rápido Clásico
RpcBindingReset No operativo Convierte en dinámico Quita el punto de conexión resuelto si hay uno presente. Quita el punto de conexión resuelto si hay uno presente.
RpcEpResolveBinding No operativo No operativo Resuelve el punto de conexión si no se resolvió anteriormente. Resuelve el punto de conexión si no se resolvió anteriormente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado rpcdce.h (incluir Rpc.h)

Consulte también

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate