estrutura RPC_ENDPOINT_TEMPLATE (rpcdce.h)

A estrutura RPC_ENDPOINT_TEMPLATE especifica as propriedades de um ponto de extremidade do servidor do grupo de interface RPC, incluindo a sequência de protocolo e o nome.

Sintaxe

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

Membros

Version

Esse campo é reservado e deve ser definido como 0.

ProtSeq

Ponteiro para um identificador de cadeia de caracteres da sequência de protocolo para registrar com a biblioteca de tempo de execução RPC. Há suporte apenas para ncalrpc, ncacn_ip_tcp e ncacn_np. Esse valor não deve ser NULL.

Endpoint

Ponteiro opcional para as informações de endereço do ponto de extremidade a serem usadas na criação de uma associação para a sequência de protocolo especificada no parâmetro Protseq . Especifique NULL para usar pontos de extremidade dinâmicos.

SecurityDescriptor

Ponteiro para um parâmetro opcional fornecido para o subsistema de segurança. Usado somente para sequências de protocolo ncacn_np e ncalrpc. Todas as outras sequências de protocolo ignoram esse parâmetro. Não é recomendável usar um descritor de segurança no ponto de extremidade para tornar um servidor seguro.

Backlog

Comprimento da fila de lista de pendências para a sequência de protocolo ncacn_ip_tcp . Todas as outras sequências de protocolo ignoram esse parâmetro. Use RPC_C_PROTSEQ_MAX_REQS_DEFAULT para especificar o valor padrão. Confira Comentários para obter mais informações.

Comentários

O valor fornecido na lista de pendências por aplicativos é apenas uma dica. O tempo de execução de RPC ou o provedor do Windows Sockets pode substituir o valor. Por exemplo, no Windows XP ou Windows 2000 Professional, o valor é limitado a 5. Os valores maiores que 5 são ignorados e 5 são usados. No Windows Server 2003 e no Windows 2000 Server, o valor será respeitado.

Os aplicativos devem ter cuidado para passar valores razoáveis na lista de pendências. Valores grandes em Servidor, Servidor Avançado ou Datacenter Server podem fazer com que uma grande quantidade de memória de pool não paginado seja usada. Usar um valor muito pequeno também é desfavorável, pois pode resultar em pacotes TCP SYN sendo atendidos pelo TCP RST do servidor se a fila de lista de pendências for esgotada.

Um desenvolvedor de aplicativos deve equilibrar os requisitos de volume de memória versus escalabilidade ao determinar o valor adequado para Backlog.

Requisitos

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

Confira também

RpcServerInqBindings