簡(jiǎn)述:
控制套接口的模式。
#include <winsock.h>
int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR* argp);
s：一個(gè)標(biāo)識(shí)套接口的描述字。
cmd：對(duì)套接口s的操作命令。
argp：指向cmd命令所帶參數(shù)的指針。
注釋：
本函數(shù)可用于任一狀態(tài)的任一套接口。它用于獲取與套接口相關(guān)的操作參數(shù)，而與具體協(xié)議或通訊子系統(tǒng)無關(guān)。支持下列命令：
FIONBIO：允許或禁止套接口s的非阻塞模式。argp指向一個(gè)無符號(hào)長(zhǎng)整型。如允許非阻塞模式則非零，如禁止非阻塞模式則為零。當(dāng)創(chuàng)建一個(gè)套接口時(shí)，它就處于阻塞模式（也就是說非阻塞模式被禁止）。這與BSD套接口是一致的。WSAAsynSelect()函數(shù)將套接口自動(dòng)設(shè)置為非阻塞模式。如果已對(duì)一個(gè)套接口進(jìn)行了WSAAsynSelect() 操作，則任何用ioctlsocket()來把套接口重新設(shè)置成阻塞模式的試圖將以WSAEINVAL失敗。為了把套接口重新設(shè)置成阻塞模式，應(yīng)用程序必須首先用WSAAsynSelect()調(diào)用（IEvent參數(shù)置為0）來禁至WSAAsynSelect()。
FIONREAD：確定套接口s自動(dòng)讀入的數(shù)據(jù)量。argp指向一個(gè)無符號(hào)長(zhǎng)整型，其中存有ioctlsocket()的返回值。如果s是SOCKET_STREAM類型，則FIONREAD返回在一次recv()中所接收的所有數(shù)據(jù)量。這通常與套接口中排隊(duì)的數(shù)據(jù)總量相同。如果S是SOCK_DGRAM 型，則FIONREAD返回套接口上排隊(duì)的第一個(gè)數(shù)據(jù)報(bào)大小。
SIOCATMARK：確實(shí)是否所有的帶外數(shù)據(jù)都已被讀入。這個(gè)命令僅適用于SOCK_STREAM類型的套接口，且該套接口已被設(shè)置為可以在線接收帶外數(shù)據(jù)（SO_OOBINLINE）。如無帶外數(shù)據(jù)等待讀入，則該操作返回TRUE真。否則的話返回FALSE假，下一個(gè)recv()或recvfrom()操作將檢索“標(biāo)記”前一些或所有數(shù)據(jù)。應(yīng)用程序可用SIOCATMARK操作來確定是否有數(shù)據(jù)剩下。如果在“緊急”（帶外）數(shù)據(jù)前有常規(guī)數(shù)據(jù)，則按序接收這些數(shù)據(jù)（請(qǐng)注意，recv()和recvfrom()操作不會(huì)在一次調(diào)用中混淆常規(guī)數(shù)據(jù)與帶外數(shù)據(jù)）。argp指向一個(gè)BOOL型數(shù)，ioctlsocket()在其中存入返回值。
兼容性：
本函數(shù)為Berkeley套接口函數(shù)ioctl()的一個(gè)子集。其中沒有與FIOASYNC等價(jià)的命令，SIOCATMARK是套接口層次支持的唯一命令。
返回值：
成功后，ioctlsocket()返回0。否則的話，返回SOCKET_ERROR錯(cuò)誤，應(yīng)用程序可通過WSAGetLastError()獲取相應(yīng)錯(cuò)誤代碼。
錯(cuò)誤代碼：
WSANOTINITIALISED：在使用此API之前應(yīng)首先成功地調(diào)用WSAStartup()。
WSAENETDOWN：WINDOWS套接口實(shí)現(xiàn)檢測(cè)到網(wǎng)絡(luò)子系統(tǒng)失效。
WSAEINVAL：cmd為非法命令，或者argp所指參數(shù)不適用于該cmd命令，或者該命令
不適用于此種類型的套接口。
WSAEINPROGRESS：一個(gè)阻塞的WINDOWS套接口調(diào)用正在運(yùn)行中。
WSAENOTSOCK：描述字不是一個(gè)套接口。
參見：
socket(), setsockopt(), getsockopt(), WSAAsyncSelect().