WinAPPCCancelAsyncRequest

WinAPPCCancelAsyncRequest函式會取消未完成的WinAsyncAPPC型要求。

語法

  
    int WINAPI WinAPPCCancelAsyncRequest(   
HANDLE hAsyncTaskID);  

參數

hAsyncTaskID
提供的參數。 指定要取消的非同步工作。

傳回值

傳回值會指定是否取消非同步要求。 如果值為零,則要求已取消。 否則,此值會是下列其中一項:

WAPPCINVALID
錯誤碼,表示指定的非同步工作識別碼無效。

WAPPCALREADY
錯誤碼,表示正在取消的非同步常式已完成。

備註

您可以藉由發出 WinAPPCCancelAsyncRequest 函式,在完成之前,藉由發出函式來取消先前啟動的非同步工作,方法是指定hAsyncTaskID中初始函數所傳回的非同步工作識別碼。

如果未處理的動詞與對話相關 (例如, SEND_DATARECEIVE_AND_WAIT) ,則會清除該動詞並關閉該會話。 如果動詞與 TP 相關 (例如, RECEIVE_ALLOCATETP_STARTED) ,則會結束 TP。 在這兩種情況下,雖然執行會盡可能徹底地關閉交談和會話,但不會排清傳送緩衝區、等候確認等等。 此呼叫是同步的,且在上述處理完成之後,會針對已取消的動詞張貼完成訊息。

如果嘗試取消現有的非同步 WinAsyncAPPC 常式失敗,錯誤碼為 WAPPCALREADY,則會發生兩件事之一。 原始常式已完成,且應用程式已處理產生的訊息,或原始常式已完成,而且產生的訊息仍在應用程式視窗佇列中等待。