RPC_ENDPOINT_TEMPLATEW 结构 (rpcdce.h)

  • 项目

RPC_ENDPOINT_TEMPLATE 结构指定 RPC 接口组服务器终结点的属性，包括协议序列和名称。

语法

typedef struct {
  unsigned long Version;
  RPC_WSTR      ProtSeq;
  RPC_WSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEW, *PRPC_ENDPOINT_TEMPLATEW;

成员

Version

此字段是保留的，必须设置为 0。

ProtSeq

指向要注册到 RPC 运行时库的协议序列的字符串标识符的指针。 仅支持 ncalrpc、ncacn_ip_tcp 和 ncacn_np。 此值不得为 NULL。

Endpoint

指向终结点地址信息的可选指针，用于为 Protseq 参数中指定的协议序列创建绑定。 指定 NULL 以使用动态终结点。

SecurityDescriptor

指向为安全子系统提供的可选参数的指针。 仅用于 ncacn_np 和 ncalrpc 协议序列。 所有其他协议序列将忽略此参数。 不建议在终结点上使用安全描述符以使服务器安全。

Backlog

ncacn_ip_tcp协议序列的积压工作队列长度。 所有其他协议序列将忽略此参数。 使用 RPC_C_PROTSEQ_MAX_REQS_DEFAULT 指定默认值。 有关更多信息，请参见备注。

注解

应用程序在 积压工作 中提供的值只是一个提示。 RPC 运行时或 Windows 套接字提供程序可能会替代 值。 例如，在 Windows XP 或 Windows 2000 专业版上，该值限制为 5。 忽略大于 5 的值，改用 5。 在 Windows Server 2003 和 Windows 2000 Server 上，将遵循该值。

应用程序必须小心地在 积压工作中传递合理的值。 服务器、高级服务器或数据中心服务器上的较大值可能会导致使用大量非分页池内存。 使用过小的值也是不利的，因为如果积压工作队列耗尽，可能会导致 TCP RST 从服务器满足 TCP SYN 数据包。

应用程序开发人员在确定 积压工作的适当值时，应平衡内存占用量和可伸缩性要求。

注意

rpcdce.h 标头将RPC_ENDPOINT_TEMPLATE定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
标头 rpcdce.h (包括 Rpc.h)

另请参阅

RpcServerInqBindings