通过

RpcServerUseProtseqIfExW 函数 （rpcdce.h）

  • 项目

RpcServerUseProtseqIfEx 函数告知 RPC 运行时库使用指定的协议序列与接口规范中用于接收远程过程调用的终结点结合使用。

语法

RPC_STATUS RpcServerUseProtseqIfExW(
  RPC_WSTR      Protseq,
  unsigned int  MaxCalls,
  RPC_IF_HANDLE IfSpec,
  void          *SecurityDescriptor,
  PRPC_POLICY   Policy
);

参数

Protseq

指向协议序列的字符串标识符的指针，用于向 RPC 运行时库注册。

MaxCalls

ncacn_ip_tcp 协议序列的积压工作队列长度。 所有其他协议序列都忽略此参数。 使用RPC_C_PROTSEQ_MAX_REQS_DEFAULT指定默认值。 请参阅“备注”。

IfSpec

包含用于为 Protseq 参数中指定的协议序列创建绑定的接口。

SecurityDescriptor

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

Policy

指向 RPC_POLICY 结构的指针，该结构包含用于限制动态端口的端口分配的标志，并允许多宿主计算机选择性地绑定到网络接口卡。

返回值

价值 意义
RPC_S_OK
 调用成功。
RPC_S_PROTSEQ_NOT_FOUND
 此协议序列的终结点未在 IDL 文件中指定。
RPC_S_PROTSEQ_NOT_SUPPORTED
 此主机上不支持协议序列。
RPC_S_INVALID_RPC_PROTSEQ
 协议序列无效。
RPC_S_INVALID_ENDPOINT_FORMAT
 终结点格式无效。
RPC_S_OUT_OF_MEMORY
 系统内存不足。
RPC_S_INVALID_SECURITY_DESC
 安全描述符无效。
 
注释 有关有效错误代码的列表，请参阅 RPC 返回值。
 

言论

RpcServerUseProtseqIfEx 的参数和效果 扩展 RpcServerUseProtseqIf。 区别在于 策略 参数，它允许限制动态端口的端口分配，并允许多宿主计算机有选择地绑定到网络接口卡。

将 RPC_POLICY 结构的 NICFlags 字段设置为 0 可使此扩展 API 在功能上等效于原始 RpcServerUseProtseqIf，并且服务器将基于系统注册表中的设置绑定到 NIC。 有关注册表设置如何定义可用的 Internet 和 Intranet 端口的信息，请参阅 为端口分配和选择性绑定配置注册表。

注意策略 字段中的标志设置仅在 ncacn_ip_tcp 或 ncadg_ip_udp 协议序列正在使用时才有效;对于所有其他协议序列，RPC 运行时将忽略这些值。
 
服务器应用程序调用 RpcServerUseProtseqIfEx，以便向 RPC 运行时库注册一个协议序列。 对于每个协议序列注册，例程包括 IDL 文件中提供的终结点地址信息。

若要接收远程过程调用请求，服务器必须至少向 RPC 运行时库注册一个协议序列。 服务器应用程序可以多次调用此例程来注册其他协议序列。

对于服务器注册的每个协议序列，RPC 运行时库将创建一个或多个终结点，服务器通过该终结点接收远程过程调用请求。 RPC 运行时库为每个协议序列创建不同的终结点。 但是，进程中的每个接口都可以通过任何终结点进行访问。 有关详细信息，请参阅编写安全 RPC 客户端或服务器。

对于 MaxCalls，应用程序提供的值只是提示。 RPC 运行时或 Windows 套接字提供程序可能会重写该值。 例如，在 Windows XP 或 Windows 2000 Professional 上，该值限制为 5。 忽略大于 5 的值，而是使用 5。 在 Windows Server 2003 和 Windows 2000 Server 上，将遵循该值。

应用程序必须小心，才能在 maxCalls中传递合理的值。 服务器、高级服务器或 Datacenter Server 上的较大值可能会导致使用大量非分页池内存。 如果积压工作队列耗尽，则使用太小的值也是不利的，因为它可能会导致来自服务器的 TCP RST 满足 TCP SYN 数据包。 在确定 MaxCalls的正确值时，应用程序开发人员应平衡内存占用与可伸缩性要求。

将计算机配置为使用选择性绑定时，成功返回不保证服务器已为计算机上存在的所有网络接口创建终结点。 RPC 运行时可能无法侦听某些网络接口，具体取决于选择性绑定设置。 此外，如果接口尚未使用 DHCP 接收 IP 地址，则 RPC 服务器在分配给该接口之前不会侦听网络接口。 成功的返回意味着服务器正在至少侦听一个网络接口;可以通过对 RpcServerInqBindings 函数的调用获取可接收远程过程调用的绑定句柄的完整列表。

若要从 IDL 文件注册所有协议序列，服务器调用 RpcServerUseAllProtseqsIfEx。 有关详细信息，请参阅 Server-Side 绑定。 有关Microsoft RPC 支持的协议序列的列表，请参阅 字符串绑定。

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 rpcdce.h （包括 Rpc.h）
库 Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

RpcServerUseAllProtseqsEx

RpcServerUseAllProtseqsIfEx

RpcServerUseProtseqEpEx

RpcServerUseProtseqEx

编写安全 RPC 客户端或服务器