WSACancelBlockingCall()

更新时间:2024-02-09 09:30

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

简述

#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 指出指定的参数之一是非法的.

免责声明
隐私政策
用户协议
目录 22
0{{catalogNumber[index]}}. {{item.title}}
{{item.title}}