简述:
控制
套接口
的模式。
#include <winsock.h>
int PASCAL FAR ioctl
socket
(
SOCKET
s, long
cmd
, u_long FAR* argp);
s:一个标识
套接口
的描述字。
cmd
:对
套接口
s的操作命令。
argp:指向
cmd
命令所带参数的
指针
。
注释:
本函数可用于任一状态的任一
套接口
。它用于获取与
套接口
相关的操作参数,而与具体协议或通讯子系统无关。支持下列命令:
FIONBIO:
允许或禁止
套接口
s的非阻塞模式。argp指向一个无符号
长整型
。如允许非阻塞模式则非零,如禁止非阻塞模式则为零。当创建一个
套接口
时,它就处于阻塞模式(也就是说非阻塞模式被禁止)。这与BSD
套接口
是一致的。WSAAsynSelect()函数将套接[口自动设置为非阻塞模式。如果已对一个
套接口
进行了WSAAsynSelect() 操作,则任何用ioctl
socket
()来把套接口]重新设置成阻塞模式的试图将以WSAEINVAL失败。为了把
套接口
重新设置成阻塞模式,
应用程序
必须首先用WSAAsynSelect()调用(IEvent参数置为0)来禁止WSAAsynSelect()。
FIONREAD:
确定
套接口
s自动读入的数据量。argp指向一个无符号
长整型
,其中存有ioctl
socket
()的返回值。如果s是SOCKET_STREAM类型,则FIONREAD返回在一次
recv()
中所接收的所有数据量。这通常与
套接口
中排队的数据总量相同。如果S是SOCK_DGRAM 型,则FIONREAD返回
套接口
上排队的第一个数据报大小。
SIOCATMARK:
确实是否所有的
带外数据
都已被读入。这个命令仅适用于SOCK_STREAM类型的
套接口
,且该套接口已被设置为可以在线接收
带外数据
(SO_OOBINLINE)。如无
带外数据
等待读入,则该操作返回TRUE真。否则的话返回FALSE假,下一个
recv()
或
recvfrom()
操作将检索“标记”前一些或所有数据。
应用程序
可用SIOCATMARK操作来确定是否有数据剩下。如果在“紧急”(带外)数据[前有常规数据,则按序接收这些数据(请注意,
recv()
和
recvfrom()
操作不会在一次调用中混淆常规数据与带外数]据)。argp指向一个BOOL型数,ioctl
socket
()在其中存入返回值。
兼容性:
本函数为Berkeley
套接口
函数ioctl()的一个子集。其中没有与FIOASYNC等价的命令,SIOCATMARK是
套接口
层次支持的唯一命令。
返回值:
成功后,ioctl
socket
()返回0。否则的话,返回SOCKET_ERROR错误,
应用程序
可通过WSAGetLastError()获取相应错误代码。
错误代码
:
WSANOTINITIALISED:在使用此
API
之前应首先成功地调用WSAStartup()。
WSAENETDOWN:WINDOWS
套接口
实现检测到网络子系统失效。
WSAEINVAL:
cmd
为非法命令,或者argp所指参数不适用于该
cmd
命令,或者该命令
不适用于此种类型的
套接口
。
WSAEINPROGRESS:一个阻塞的WINDOWS
套接口
调用正在运行中。
WSAENOTSOCK:描述字不是一个
套接口
。
参见:
socket
(),
setsockopt()
, getsockopt(), WSAAsyncSelect().
该命令
不适用于此种类型的套接口。
WSAEINPROGRESS:
一个阻塞的WINDOWS套接口调用正在运行中。
WSAENOTSOCK:
描述字不是一个套接口。
转载于:https://my.oschina.net/osbin/blog/97006