1简述:
控制
套接口的模式。
#include <winsock.h>
s:一个标识
套接口的描述字。
2注释:
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()在其中存入返回值。
3兼容性:
4返回值:
错误代码:
WSANOTINITIALISED:在使用此
API之前应首先成功地调用WSAStartup()。
WSAENETDOWN:WINDOWS
套接口实现检测到网络子系统失效。
不适用于此种类型的
套接口。
WSAEINPROGRESS:一个阻塞的WINDOWS
套接口调用正在运行中。
WSAENOTSOCK:描述字不是一个
套接口。
5参见:
socket(),
setsockopt(), getsockopt(), WSAAsyncSelect().
该命令
不适用于此种类型的套接口。
WSAEINPROGRESS:一个阻塞的WINDOWS套接口调用正在运行中。
WSAENOTSOCK:描述字不是一个套接口。
6使用方法
下面这段代码演示了
ioctlsocket函数的使用方式
C++代码
#include <winsock2.h>
#include <stdio.h>
#pragma comment(lib, "Ws2_32.lib")
void main(){
//-------------------------
// Initialize Winsock
WSADATA wsaData;
int iResult;
u_long iMode = 0;
iResult = WSAStartup(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 disables 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);
}