RPC_BINDING_HANDLE_TEMPLATE_V1_A struttura (rpcdce.h)

Articolo
03/15/2023

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_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;

Members

Version

Versione di questa struttura. Per RPC_BINDING_HANDLE_TEMPLATE_V1 è necessario impostare su 1.

Flags

Contrassegno valori 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

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

RPC_PROTSEQ_LRPC : specifica RPC locale.
RPC_PROTSEQ_TCP : specifica RPC su TCP/IP.
RPC_PROTSEQ_NMP : specifica RPC su pipe denominate.
RPC_PROTSEQ_HTTP : specifica RPC su HTTP.

NetworkAddress

Puntatore a una rappresentazione stringa dell'indirizzo di rete da associare.

StringEndpoint

Puntatore a una rappresentazione stringa dell'endpoint da associare. 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 di un'associazione di stringhe. Dopo aver creato l'handle di associazione, chiamare RpcBindingSetObject per modificare l'UUID in base alle esigenze.

Commenti

I 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

RpcBindingBindd

RpcBindingCreate

Condividi tramite