| 词条 | WSACancelAsyncRequest() |
| 释义 | § 简述: 取消一次未完成的异步操作. #include <winsock.h> int PASCAL FAR WSACancelAsyncRequest(HANDLE hAsyncTackHandle); hAsyncTaskHandle 指明要取消的异步操作. § 注释: 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(). |
| 随便看 |
百科全书收录594082条中文百科知识，基本涵盖了大多数领域的百科知识，是一部内容开放、自由的电子版百科全书。