Compartilhar via


atributo de ponto de extremidade

O atributo [ponto de extremidade] especifica uma porta ou portas conhecidas (pontos de extremidade de comunicação) em que os servidores da interface escutam chamadas.

endpoint("protocol-sequence:[endpoint-port]" [ , ...] )

Parâmetros

sequência de protocolo

Especifica uma cadeia de caracteres que representa uma combinação válida de um protocolo RPC (como "ncacn"), um protocolo de transporte (como "tcp" e um protocolo de rede (como "ip"). Para obter uma lista de sequências de protocolo válidas, consulte Constantes de sequência de protocolo.

endpoint-port

Especifica uma cadeia de caracteres que representa a designação de ponto de extremidade para a família de protocolos especificada. A sintaxe da cadeia de caracteres de porta é específica para cada sequência de protocolo.

Comentários

O atributo [ponto de extremidade] especifica uma família de transporte, como o protocolo orientado para conexão TCP/IP, um protocolo orientado para conexão NetBIOS ou o protocolo orientado para conexão de pipe nomeado. O uso do atributo [ponto de extremidade] é consistente com outros métodos para adicionar um ponto de extremidade e não fornece serviços adicionais ou especiais para o ponto de extremidade; ele simplesmente fornece um atalho para chamar a API.

Observação

Especificando um ponto de extremidade no . A definição da interface IDL não restringe o acesso à interface ao ponto de extremidade especificado. Adicionando um ponto de extremidade ao . A definição da interface IDL permite que a interface seja chamada por meio de qualquer ponto de extremidade nesse processo e permite que o ponto de extremidade seja usado para chamar outras interfaces nesse processo.

 

O valor da sequência de protocolo determina os valores válidos para a porta do ponto de extremidade. O compilador MIDL verifica apenas a sintaxe geral da entrada endpoint-port . Os erros de especificação de porta são relatados pelas bibliotecas em tempo de execução. Para obter informações sobre os valores permitidos para cada sequência de protocolo, consulte As Constantes de Sequência de Protocolo.

As seguintes sequências de protocolo especificadas pelo DCE não são compatíveis com o compilador MIDL fornecido com o Microsoft RPC: ncacn_osi_dna e ncadg_dds.

Certifique-se de citar corretamente caracteres de barra invertida em pontos de extremidade. Esse erro geralmente ocorre quando o ponto de extremidade é um pipe nomeado.

As informações de ponto de extremidade especificadas no arquivo IDL são usadas pelas funções de tempo de execução RPC RpcServerUseProtseqIf e RpcServerUseAllProtseqsIf.

Exemplos

endpoint("ncacn_np:[\\pipe\\rainier]") 

endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")

Confira também

Arquivo IDL (definição de interface)

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf