终结点属性

  • 项目

[endpoint] 属性指定一个或多个已知端口， (通信终结点) 接口的服务器侦听呼叫。

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

parameters

protocol-sequence

指定表示 RPC 协议 (（如“ncacn”) 、传输协议 (（如“tcp”) ）和网络协议 (（如“ip”) ）的有效组合的字符串。 有关有效协议序列的列表，请参阅 协议序列常量。

endpoint-port

指定表示指定协议系列的终结点指定的字符串。 端口字符串的语法特定于每个协议序列。

备注

[endpoint] 属性指定一个传输系列，例如面向 TCP/IP 连接的协议、面向 NetBIOS 连接的协议或面向命名管道连接的协议。 [endpoint] 属性的使用与其他添加终结点的方法一致，并且不为终结点提供其他或特殊服务;它只是提供调用 API 的快捷方式。

注意

在 中指定终结点。IDL 接口定义不会将接口的访问限制为指定的终结点。 将终结点添加到 。IDL 接口定义允许通过该进程中的任何终结点调用接口，并允许使用该终结点调用该进程中的其他接口。

 

协议序列值确定终结点端口的有效值。 MIDL 编译器仅检查 终结点端口 条目的常规语法。 端口规范错误由运行时库报告。 有关每个协议序列允许的值的信息，请参阅 协议序列常量。

MICROSOFT RPC 随附的 MIDL 编译器不支持 DCE 指定的以下协议序列： ncacn_osi_dna 和 ncadg_dds。

请确保在终结点中正确用反斜杠字符引起来。 当终结点是命名管道时，通常会发生此错误。

在 IDL 文件中指定的终结点信息由 RPC 运行时函数 RpcServerUseProtseqIf 和 RpcServerUseAllProtseqsIf 使用。

示例

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

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

另请参阅

接口定义 (IDL) 文件

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf