RpcServerTestCancel 函数 (rpcdce.h)

项目
03/01/2024

服务器调用 RpcServerTestCancel 来测试客户端取消请求。

语法

RPC_STATUS RpcServerTestCancel(
  RPC_BINDING_HANDLE BindingHandle
);

参数

BindingHandle

调用以测试取消命令。如果指定值零，服务器将模拟由此服务器线程提供服务的客户端。

返回值

值	含义
RPC_S_OK	客户端取消了调用。服务器仍必须完成或中止调用。
RPC_S_NO_CALL_ACTIVE	当前线程上没有活动调用。
RPC_S_CALL_IN_PROGRESS	呼叫未取消。
RPC_S_INVALID_BINDING	句柄无效。

注意有关有效错误代码的列表，请参阅 RPC 返回值。

注解

服务器调用 RpcServerTestCancel 来查明客户端是否已请求取消未完成的调用。 RpcServerTestCancel 函数仅指示客户端是否已取消调用;服务器或客户端上的状态未更改。已取消的调用仍必须由 RPC 服务器分别使用 RpcAsyncCompleteCall 或 RpcAsyncAbortCall 函数调用完成或中止。

BindingHandle 参数指定要对其进行测试的调用。如果参数的值为零，则测试当前线程上的调用。服务器可以调用 RpcServerTestCancel (RpcAsyncGetCallHandle (pAsync) ) 函数，以使用异步句柄来测试取消消息以获取绑定句柄。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	rpcdce.h (包括 Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll