endpoint 属性

[endpoint] 属性指定 (通信终结点) 接口的服务器侦听调用的已知端口或端口。

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

参数

protocol-sequence

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

endpoint-port

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

注解

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

注意

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

 

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

MICROSOFT RPC 提供的 MIDL 编译器不支持 DCE 指定的以下协议序列: ncacn_osi_dnancadg_dds

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

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

示例

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

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

另请参阅

接口定义 (IDL) 文件

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf