终结点属性
[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]")
另请参阅