Função RpcServerUseProtseqExW (rpcdce.h)
A função RpcServerUseProtseqEx informa à biblioteca de tempo de execução RPC para usar a sequência de protocolo especificada para receber chamadas de procedimento remoto.
Sintaxe
RPC_STATUS RpcServerUseProtseqExW(
RPC_WSTR Protseq,
unsigned int MaxCalls,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
Parâmetros
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.
MaxCalls
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.
SecurityDescriptor
Ponteiro para um parâmetro opcional fornecido para o subsistema de segurança do Windows XP/2000/NT. Usado apenas para ncacn_np e sequências de protocolo 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. Esse parâmetro não aparece na especificação DCE para essa API.
Policy
Ponteiro para a estrutura de RPC_POLICY, que contém sinalizadores para restringir a alocação de porta para portas dinâmicas e permitir que computadores multihomed se associem seletivamente a cartões de interface de rede. A estrutura RPC_POLICY permite que o chamador direcione a biblioteca de tempo de execução RPC para usar uma porta de intranet ou uma porta da Internet, entre outras opções.
Valor de retorno
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
Não há suporte para a sequência de protocolos neste host. |
|
A sequência de protocolo. |
|
O sistema está sem memória. |
|
O descritor de segurança é inválido. |
Observações
Os parâmetros e efeitos de RpcServerUseProtseqEx subsume os de RpcServerUseProtseq. A diferença é o campo Policy, que permite restringir a alocação de porta para portas dinâmicas e permite que computadores multihomed se associem seletivamente a cartões de interface de rede.
Definir o campo NICFlags da estrutura RPC_POLICY como zero torna essa função estendida funcionalmente equivalente à RpcServerUseProtseq original e o servidor será associado a NICs com base nas configurações no registro do sistema. Para obter informações, consulte Configurando o Registro para Alocações de Porta ede Associação Seletiva.
Para cada sequência de protocolo registrada por um servidor, a biblioteca de tempo de execução do RPC cria um ou mais pontos de extremidade por meio dos quais o servidor recebe solicitações de chamada de procedimento remoto. A biblioteca de tempo de execução RPC cria pontos de extremidade diferentes para cada sequência de protocolo. O nome do ponto de extremidade é gerado pelo tempo de execução do RPC ou pelo sistema operacional. Por exemplo, para ncacn_ip_tcp, o número da porta é determinado dinamicamente pelo tempo de execução do RPC, dependendo das configurações de disponibilidade e registro.
Para maxcalls, o valor fornecido pelo aplicativo é 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 em maxcalls. 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 equilibrar os requisitos de volume de memória versus escalabilidade ao determinar o valor adequado para maxcalls.
Quando o computador está configurado para usar a associação seletiva, o retorno bem-sucedido não garante que o servidor tenha criado pontos de extremidade para todos os adaptadores de rede presentes no computador. O tempo de execução do RPC pode não escutar alguns adaptadores de rede, dependendo das configurações de associação seletiva. Além disso, se uma interface ainda não recebeu um endereço IP usando DHCP, o servidor RPC não escuta no adaptador de rede até que um endereço DHCP seja atribuído a ele. Um retorno bem-sucedido implica que o servidor está escutando em pelo menos um adaptador de rede; a lista completa dos identificadores de associação sobre os quais chamadas de procedimento remoto podem ser recebidas pode ser obtida com uma chamada para a função RpcServerInqBindings.
Para registrar todas as sequências de protocolo, um servidor chama rotina de RpcServerUseAllProtseqsEx.
Para obter mais informações, consulte Server-Side Binding.
Nota
O cabeçalho rpcdce.h define RpcServerUseProtseqEx 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 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | rpcdce.h (inclua Rpc.h) |
| biblioteca | Rpcrt4.lib |
| de DLL |
Rpcrt4.dll |