Compartilhar via

estrutura RPC_BINDING_HANDLE_TEMPLATE_V1_W (rpcdce.h)

  • Artigo

A estrutura RPC_BINDING_HANDLE_TEMPLATE_V1 contém as opções básicas com as quais criar um identificador de associação RPC.

Sintaxe

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;

Membros

Version

A versão dessa estrutura. Para RPC_BINDING_HANDLE_TEMPLATE_V1 isso deve ser definido como 1.

Flags

Valores de sinalizador que descrevem propriedades específicas do modelo RPC.

Valor Significado
RPC_BHT_OBJECT_UUID_VALID
 O membro ObjectUuid contém um valor válido. Se esse sinalizador não estiver definido, o membro ObjectUuid não conterá um UUID válido.

ProtocolSequence

Um literal de cadeia de caracteres de sequência de protocolo associado a esse identificador de associação. Pode ser um dos seguintes valores.

ncalrpc – especifica o RPC local. ncacn_ip_tcp – especifica RPC por TCP/IP. ncacn_np – especifica rpc sobre pipes nomeados. ncacn_http – especifica RPC por HTTP.

NetworkAddress

Ponteiro para uma representação de cadeia de caracteres do endereço de rede ao qual associar.

StringEndpoint

Ponteiro para uma representação de cadeia de caracteres do ponto de extremidade ao qual associar. Se um ponto de extremidade dinâmico for usado, defina esse membro como NULL. Depois que o ponto de extremidade for resolvido, use RpcBindingToStringBinding para obtê-lo.

u1

u1.Reserved

Reservado. Esse membro deve ser definido como NULL.

ObjectUuid

O UUID do objeto remoto. A semântica dessa UUID é a mesma de uma associação de cadeia de caracteres. Depois que o identificador de associação for criado, chame RpcBindingSetObject para alterar a UUID conforme necessário.

Comentários

Os identificadores de associação rápida são ligeiramente diferentes dos identificadores de associação "clássicos" na maneira como são tratados durante as chamadas para RpcBindingReset. RpcBindingReset é uma chamada sem operações para identificadores de associação rápida estáticos. No entanto, para identificadores de associação clássicos, RpcBindingReset converte um identificador de associação estático em um dinâmico para preservar a compatibilidade com versões anteriores.

A tabela a seguir demonstra o comportamento de identificadores de associação estática e dinâmica em relação a RpcBindingReset e RpcEpResolveBinding.

Tipo de Ponto de Extremidade Estático Dinâmico
Tipo de identificador de associação Rápido Clássico Rápido Clássico
RpcBindingReset Sem operações Converte em dinâmico Remove o ponto de extremidade resolvido se houver um Remove o ponto de extremidade resolvido se houver um
RpcEpResolveBinding Sem operações Sem operações Resolve o ponto de extremidade se não for resolvido anteriormente Resolve o ponto de extremidade se não for resolvido anteriormente

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho rpcdce.h (inclua Rpc.h)

Confira também

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate