estrutura RPC_ENDPOINT_TEMPLATEW (rpcdce.h)

Artigo
11/20/2024

A estrutura de 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_WSTR      ProtSeq;
  RPC_WSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEW, *PRPC_ENDPOINT_TEMPLATEW;

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 a ser registrado na biblioteca de tempo de execução do RPC. Há suporte apenas ncalrpc, ncacn_ip_tcp e ncacn_np. Esse valor não deve ser NULL.

Endpoint

Ponteiro opcional para as informações de endereço de 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 apenas para sequências de protocolo ncalrpc e ncacn_np. 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 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. Consulte Comentários para obter mais informações.

Observações

O valor fornecido em de backlog por aplicativos é apenas uma dica. O tempo de execução do RPC ou o provedor de Soquetes do Windows pode substituir o valor. Por exemplo, no Windows XP ou no Windows 2000 Professional, o valor é limitado a 5. 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 node backlog do . Valores grandes no Servidor, Servidor Avançado ou Servidor datacenter 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 pendências for esgotada.

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

Nota

O cabeçalho rpcdce.h define RPC_ENDPOINT_TEMPLATE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

RpcServerInqBindings

Compartilhar via