struttura RPC_BINDING_HANDLE_TEMPLATE_V1_W (rpcdce.h)

Articolo
03/05/2024

La struttura RPC_BINDING_HANDLE_TEMPLATE_V1 contiene le opzioni di base con cui creare un handle di associazione RPC.

Sintassi

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;

Members

Version

Versione di questa struttura. Per RPC_BINDING_HANDLE_TEMPLATE_V1 questo valore deve essere impostato su 1.

Flags

Valori di flag che descrivono proprietà specifiche del modello RPC.

Valore	Significato
RPC_BHT_OBJECT_UUID_VALID	Il membro ObjectUuid contiene un valore valido. Se questo flag non è impostato, il membro ObjectUuid non contiene un UUID valido.

ProtocolSequence

Valore letterale stringa della sequenza di protocollo associato a questo handle di associazione. Può essere uno dei valori seguenti.

ncalrpc : specifica rpc locale. ncacn_ip_tcp : specifica RPC su TCP/IP. ncacn_np : specifica RPC su named pipe. ncacn_http : specifica RPC su HTTP.

NetworkAddress

Puntatore a una rappresentazione di stringa dell'indirizzo di rete a cui eseguire l'associazione.

StringEndpoint

Puntatore a una rappresentazione di stringa dell'endpoint a cui eseguire l'associazione. Se viene usato un endpoint dinamico, impostare questo membro su NULL. Dopo aver risolto l'endpoint, usare RpcBindingToStringBinding per ottenerlo.

u1

u1.Reserved

Riservato. Questo membro deve essere impostato su NULL.

ObjectUuid

UUID dell'oggetto remoto. La semantica per questo UUID è uguale a quella per un'associazione di stringhe. Dopo aver creato l'handle di associazione, chiamare RpcBindingSetObject per modificare l'UUID in base alle esigenze.

Commenti

Gli handle di associazione rapida sono leggermente diversi dagli handle di associazione "classici" nel modo in cui vengono gestiti durante le chiamate a RpcBindingReset. RpcBindingReset è una chiamata no-op per handle di associazione rapida statici. Per gli handle di associazione classici, tuttavia, RpcBindingReset converte un handle di associazione statico in uno dinamico per mantenere la compatibilità con le versioni precedenti.

Nella tabella seguente viene illustrato il comportamento degli handle di associazione statici e dinamici relativi a RpcBindingReset e RpcEpResolveBinding.

Tipo di endpoint	Statico		Dynamic
Tipo di handle di associazione	Veloce	Classic	Veloce	Classic
RpcBindingReset	No-op	Converte in dinamica	Rimuove l'endpoint risolto se presente	Rimuove l'endpoint risolto se presente
RpcEpResolveBinding	No-op	No-op	Risolve l'endpoint se non è stato risolto in precedenza	Risolve l'endpoint se non è stato risolto in precedenza

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	rpcdce.h (include Rpc.h)

Vedi anche

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingCreate

Condividi tramite