WSACancelAsyncRequest()简介_WSACancelAsyncRequest()个人资料_WSACancelAsyncRequest()微博_百科网
A-A+

WSACancelAsyncRequest()简介_WSACancelAsyncRequest()个人资料_WSACancelAsyncRequest()微博

2018-04-16 06:04:18 科学百科 阅读 1 次

简述:/WSACancelAsyncRequest() 编辑


        取消一次未完成的异步操作.
        #include <winsock.h>
        int PASCAL FAR WSACancelAsyncRequest(HANDLE hAsyncTackHandle);
       
        hAsyncTaskHandle   指明要取消的异步操作.

注释:/WSACancelAsyncRequest() 编辑


        WSACancelAsyncRequest()函数用于取消一次异步操作,该异步操作应是以一个WSAAsyncGetXByY()函数(诸如WSAAsyncGetHostByName())启动的.hAsyncTaskHandle参数标识了要取消的操作,它应由初始函数作为异步任务句柄返回.

返回值:
        0           异步操作成功地被取消.
        SOCKET_ERROR    其它情况.(同时可通过调用WSAGetLastError()获得错误代码)

评论:
        试图取消一个已存在的异步操作WSAAsyncGetXByY()可能失败(错误代码WSAEALREADY),原
因有二:首先,原来的操作已经完成,并且应用程序已经处理了结果消息。其次,原始操作已经完成,但结果消息仍在应用程序窗口队列中等待。

关于Windows Sockets提供者的说明:
        应用程序是否能有效地区分WSAEINVAL和WSAEALREADY是不清楚的,因为在这两种情况下,错误代码指出不存在指定句柄的异步操作在运行。(小例外:0总是非法的异步任务句柄。)Windows Sockets规格说明不会规定一个Windows Sockets实现怎样区分这两种情况。最大可能的情况是,Windows Sockets应用程序应将两种错误视为相同。

错误代码:
        WSANOTINITIALISED       在使用本API前必须进行一次成功的WSAStartup()调用.
        WSAENETDOWN     WINDOWS SOCKETS实现已检测到网络子系统故障.  
        WSAEINVAL           指出指定的参数之一是非法的.
        WSAEINPROGRESS      一个阻塞的Windows Sockets操作正在进行.
        WSAEALREADY     被废除的异步调用已经完成.

参见:
        WSAAsyncGetHostByAddr(), WSAAsyncGetHostByName(), WSAAsyncGetProtoByNumber(), WSAAsyncGetProtoByName(), WSAAsyncGetHostByName(), WSAAsyncGetServByPort(), WSAAsyncGetServByName().