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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	rpcdce.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll