简述

注释(阻塞操作 备注)

简述

取消一次正在进行中的阻塞调用。

#include <winsock.h>

int PASCAL FAR WSACancelBlockingCall( void );

注释

阻塞操作

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

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

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

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

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

取消一个accept()或select()调用不会迫使套接口经过这些调用。只有特殊的调用会失败H魏卧谌∠??昂戏ǖ牟僮髟谌∠??笠餐??戏ǎ?捉涌诘淖刺?谌魏吻榭鱿露疾换崾苡跋臁*

取消任何除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 指出指定的参数之一是非法的.