struttura RPC_ENDPOINT_TEMPLATE (rpcdce.h)

Articolo
08/25/2023

La struttura RPC_ENDPOINT_TEMPLATE specifica le proprietà di un endpoint server del gruppo di interfacce RPC, inclusa la sequenza di protocollo e il nome.

Sintassi

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATE, *PRPC_ENDPOINT_TEMPLATE;

Members

Version

Questo campo è riservato e deve essere impostato su 0.

ProtSeq

Puntatore a un identificatore stringa della sequenza di protocollo da registrare con la libreria di runtime RPC. Sono supportati solo ncalrpc, ncacn_ip_tcp e ncacn_np. Questo valore non deve essere NULL.

Endpoint

Puntatore facoltativo alle informazioni sull'indirizzo endpoint da usare per la creazione di un'associazione per la sequenza di protocollo specificata nel parametro Protseq . Specificare NULL per usare endpoint dinamici.

SecurityDescriptor

Puntatore a un parametro facoltativo fornito per il sottosistema di sicurezza. Usato solo per le sequenze di protocollo ncacn_np e ncalrpc. Tutte le altre sequenze di protocollo ignorano questo parametro. Non è consigliabile usare un descrittore di sicurezza nell'endpoint per proteggere un server.

Backlog

Lunghezza coda backlog per la sequenza di protocollo ncacn_ip_tcp . Tutte le altre sequenze di protocollo ignorano questo parametro. Usare RPC_C_PROTSEQ_MAX_REQS_DEFAULT per specificare il valore predefinito. Per ulteriori informazioni, vedere la sezione Osservazioni.

Commenti

Il valore fornito in Backlog dalle applicazioni è solo un hint. Il runtime RPC o il provider Windows Sockets può eseguire l'override del valore. Ad esempio, in Windows XP o Windows 2000 Professional, il valore è limitato a 5. I valori maggiori di 5 vengono ignorati e vengono usati 5. In Windows Server 2003 e Windows 2000 Server, il valore verrà rispettato.

Le applicazioni devono prestare attenzione a passare valori ragionevoli nel backlog. I valori di grandi dimensioni nel server, nel server avanzato o nel server datacenter possono causare l'uso di una grande quantità di memoria del pool non di paging. Anche l'uso di un valore troppo piccolo non è favorevole, perché può comportare l'esaurimento dei pacchetti TCP SYN da parte di TCP RST dal server.

Uno sviluppatore di applicazioni deve bilanciare il footprint di memoria rispetto ai requisiti di scalabilità quando si determina il valore appropriato per il backlog.

Requisiti

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

Vedi anche

RpcServerInqBindings

Condividi tramite