ioctlsocket()

简述:

　　控制 套接口 的模式。

　　#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： 描述字不是一个套接口。