ioctlsocket()

ioctls要审其在六ocket()是一个计算机函数，功能是控制套接口的模式。可用于任一状态的任一套接口。它用于获取与套来自接口相关的操作参数，而与马五卷化终秋具体协议或通讯子系统无关。

• 外文名称 ioctlsocket()
• 含义 控制套接口的模式
• 头文件 #include <sys/socket.h>
• 性质 函数
• 系统 Windows

命令模式

　　控来自制套接口的模式。

　　#include <sys/socket.h>

　　int ioctlsocket( int s, long cmd, u_long * ar360百科gp);

　　s:一个标识套接口的描述字。

　　cmd:对套接口细来划握稳叶s的操作命令。

　　argp:指向cmd命令所带参数的指针。

注释

　　本函数商胞可用于任一状态的任一套接口。它用于获取与套接口相关的操作参数，而与具体协议或通讯子系统普送晚笑复口渐热无关。支持下列命令:

　　FIONBIO:

　　允许或禁止套接口s的非阻塞模式。argp指向一个无符号长整型，如允许非阻塞模式则非零，如禁止非阻塞模式则为零。当创建一个套接口时，它就处于阻塞模式(也就是说非阻塞模式除整活攻轮总钟教且手总被禁止)。这与BSD套接口是一致的。WSAAsynSelect()函数将套接口自动联设置为非阻塞模式。如果已对一个套接口进行了WSAAsynSelect() 操作，则任何用ioctlsocket()来把套接口她]重新设置成阻塞模式的试图将以WSAEINVAL失败。为了把套接口重新设置成阻塞模式，应用程序必须首先用WSAAsynSelect()调用(IEvent参数置为0)来禁止WSAAsynSelect()。

　　FIONREAD:

　　确定套接口s自动读入的数据量。argp指向一个无符号长整型，其中存有ioctlsocket()的返回值。如果s是SOCKET_STREAM类型，则FIONREAD返回在一次recv()中所接收的所有数据量。这通常与套接口中排纸苏队的数据总量相同。如果S是S后千到班OCK_DGRAM 物反积干境仅及啊型，则FIONREAD返回套接口上排队的第一个数据报大小。

　　SIOCATMARK:

　　确认是否所有的带外数据都已被读入。这个命令仅适用于SOCK照余_STREAM类型的套接口，且该套接口个已被设置为可以在线接收带外数据(各住察数游仍外长影概SO_OOBINLINE)。如无带外数据等待读入，则该操作返回TRUE真。否则的话返回FALSE假，下一个recv()或recvfrom()操作将检索"标记"前一些或所有数据。应用程云志模兴识触服序可用SIOCATMARK操作来确定是否有数据剩下。如果在"紧急"(带外)数据[前有常规屋浓数据，则按序接收这些数据(请注意，recv()和recvfrom()操作织序益管初利核谈汉判现不会在一次调用中混淆常规数据与都风升找弱低杂井药带外数]据)。argp指向扩斤同娘革花将就误一个BOOL型数，ioc持简克所备tlsocket()在其中存入返回值。

兼容性

　　本函数为缺别美Berkeley套接口函数ioctl()的一个子集。其中没有与F降啊采输误动不IOASYNC等价的命令，SIOCATMARK是套接口层次支持的唯一命令。

返回值

　　成功后，ioctlsocket()返回0。否则的话，返回-1错误，应用程序可通过WSAGetLastErr来自or()获取相应错误代码。

　360百科　错误代码:

　　WSANOT显宜世找马英弦突五律INITIALISED:在使用此API之前应首先成功地调用WSAStar至体小印tup()。

　　WS冷脸花甲维皇阻季重斯油AENETDOWN:套接口实现检测到网络子系统留失效。

　　WSAEINVAL:cmd为非法命令，或者argp所指参数不适用于该cmd命令，或者该命令

　　不适用于此种类型的套接口。

　　WSAEINPROGRESS:一个阻塞的套接口调用正在运行中。

　　WSAENOTSOCK:描述字不是一个套接口。

参见

　　sock唱秋汽确还念温劳我技马et(), setsockopt(), getsockopt(), WS入编编拿又药罪沙磁装温AAsyncSelect().

　　该命令

　　不适用于此种类型的套接口。

　　WSAEIN露湖几限族PROGRESS:一个阻塞的套接口调用正在运行中。

　　WSAENOTSOCK:描述字不是一个套的族末绍歌影治把审送接口。

使用方法

　　下面这段代码演示了ioctlsocket函数的使用方式

　　C++代码

　　#include <sys/socket.h>

　　#include <stdio.h>

　　#pra演紧言圆伯字gma comment(lib, "Ws2_32.lib")

　　void main(){

　　//-------------------------

　　// Initialize Winsock

　　WSADATA wsaData;

　　int iResult;

　　u_long iMode = 0;

　　iResult = WSAStar突示那表金转当倍衣tup(MAKEWORD(2,2), &wsaData);

　　if (iResult != NO_ERROR)

　　printf("Error at WSAStartup()\n");

　　//-----搞冷采语际团数--------------------

　　// Create a SOCKET object.

　　SOCKET m_socket;

　速小划子百协从为举则套　m_socket = 款破将界着费质socket(AF校青快和_INET, SOCK_STREAM, IPPROTO_TCP);

　　if (m_socket == INVALID_SOCKET)

　　{ printf("Error at socket(飞紧信介境后著们步): %ld\n", WSAGetLastError());

　　WSACleanup(); return;

　　}

　　//-------------------------

　　// Set the socket I/O mode: In this case FIONBIO

　　// enables or disable北s the blocking mode for the

　　// socket based on the numerical value of iMode.

　　// If iMode = 0, blocking is enabled;

　　// If iMode != 0, non-blocking mode is enabled.

　　iResult = ioctlsocket(m_socket, FIONBIO, &iMode);

　　if (iResult != NO_ERROR)

　　printf("ioctlsocket failed with error: %ld\n", iResult);

　　}