rpcMgmtSetComTimeout 函数 (rpcdce.h)

  • 项目

RpcMgmtSetComTimeout 函数在绑定句柄中设置绑定通信超时值。

语法

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

parameters

Binding

设置超时值的服务器绑定句柄。

Timeout

通信超时值，从 0 到 10。 这些值不是秒;它们表示从 0 到 10 的相对时间量。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_INVALID_BINDING
 绑定句柄无效。
RPC_S_INVALID_TIMEOUT
 超时值无效。
RPC_S_WRONG_KIND_OF_BINDING
 这是操作的错误绑定类型。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

在 Windows XP 和 Windows 2000 中，在绑定期间，RPC 运行时使用较短的 15 分钟调用超时，并使用 RpcMgmtSetComTimeout 函数的超时集。 在绑定之后的交换中，RPC 运行时仅使用 RpcMgmtSetComTimeout 函数在 中设置的超时。 对于 ncalrpc 和 ncadg_* 协议序列，将忽略此选项。

客户端应用程序调用 RpcMgmtSetComTimeout 来更改服务器绑定句柄的通信超时值。 根据指定绑定句柄的协议序列，超时值仅充当 RPC 运行时库的提示。 每个协议序列都以不同的方式解释此设置; 对于 ncacn_ip_tcp， 值用于为所有调用启用 keep-alives。 例如，对于 ncacn_ip_tcp，如果将 Timeout 设置为零，则指示 RPC 在 60 秒内未收到响应， (60 秒间隔特定于实现且可能会) 更改。 在这种情况下，只要服务器运行，客户端调用就不会超时;但是，如果服务器发生故障或丢失其 IP 地址，则 RPC 将失败调用。 TCP 超时提示在建立连接期间以及请求/答复交换期间使用。

注意 使用 TCP 超时提示是检测故障服务器的最佳做法。

在 Windows XP 中，当服务器响应时，将关闭给定连接的保持连接。

 
为方便起见，为超时范围中的某些值提供了常量。 有关应用程序可用于超时参数的 RPC 定义值的列表，请参阅 绑定超时常量。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

请参阅

RpcMgmtInqComTimeout