终结点属性

[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_dnancadg_dds

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

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

示例

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

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

另请参阅

接口定义 (IDL) 文件

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf