WSACancelBlockingCall()是一个C语言，为取消一次正在进行中的阻塞调用。

#include

int PASCAL FAR WSACancelBlockingCall(void);

本函数取消了任何本任务中尚未完成的阻塞操作。通常用于以下两种情况：

⑴。在一个阻塞调用进行时，应用程序同时在处理接收到的消息。在这种情况下，WSAIsBlocking( )返回True.

⑵。一个阻塞调用在进行时，Windows Sockets已经回调了应用程序的“阻塞钩子“函数。（如WSASetBlockingHook( )）

在每种情况中，原来的阻塞调用将尽快中止，并产生错误码WSAEINTR。（在⑴中，中止发生在Windows消息调度将控制转移到Windows Sockets的阻塞例程中时。在⑵中，阻塞调用将在阻塞钩子函数完成时中止。）

在进行阻塞的connect( )操作的情况下，Windows Sockets的实现将尽可能中止阻塞调用，但在连接完成（已经复位）或超时之前，它不可能释放套接口资源。同样值得注意的是在应用程序立即尝试打开一个新的套接口（若没有可用的套接口）或试图连接（connect（））同一个套接口时。

取消一个accept( )或select( )调用不会迫使套接口经过这些调用。只有特殊的调用会失败.

取消任何除accept（ ）和select（ ）之外的操作可能导致套接口进入非终结的状态.如果一个应用程序取消了一个套接口上的阻塞操作，应用程序唯一可以在套接口上操作的函数调用就是CloseSocket( ). 尽管其它一些操作可以在一些Windows Sockets实现上运作。如果一个应用程序想获得最大的可移植性，它必须注意不要在取消操作后依赖于performing operations.应用程序可通过置SO_LINGER上的超时为0来重置连接。

如果一个取消操作损害了SOCK_STREAM的数据流的完整性，Windows Sockets实现必须重建连接并且用WSAECONNABORTED使所有将来的操作（除了closesocket( )）失败。

返回值：

0 操作成功地被取消。

SOCKET_ERROR 其它。（可通过WSAGetLastError（ ）获得相应错误代码）

评价：

注意网络操作在WSACancelBlockingCall（ ）运行之前完成是可能的。例如，在应用程序处于阻塞钩子中时数据可以在中断时接收到用户缓冲区。在这种情况下，阻塞操作将成功返回如同WSACancelBlockingCall（ ）从未调用过。注意WSACancelBlockingCall（ ）仍是成功的。确认一个操作是否真正地被取消的唯一办法是检查从阻塞调用的WSAEINTR的返回值。

错误代码：

WSANOTINITIALISED 在使用本API前必须进行一次成功的WSAStartup（ ）调用.

WSAENETDOWN WINDOWS SOCKETS实现已检测到网络子系统故障.

WSAEINVAL 指出指定的参数之一是非法的.