| 簡(jiǎn)述：
設置套接口的選項。
#include <winsock.h>
int PASCAL FAR setsockopt( SOCKET s, int level, int optname,
const char FAR* optval, int optlen);
s：標識一個(gè)套接口的描述字。
level：選項定義的層次；目前僅支持SOL_SOCKET和IPPROTO_TCP層次。
optname：需設置的選項。
optval：指針，指向存放選項值的緩沖區。
optlen：optval緩沖區的長(cháng)度。
注釋?zhuān)?br> setsockopt()函數用于任意類(lèi)型、任意狀態(tài)套接口的設置選項值。盡管在不同協(xié)議層上存在選項，但本函數僅定義了最高的“套接口”層次上的選項。選項影響套接口的操作，諸如加急數據是否在普通數據流中接收，廣播數據是否可以從套接口發(fā)送等等。
有兩種套接口的選項：一種是布爾型選項，允許或禁止一種特性；另一種是整形或結構選項。允許一個(gè)布爾型選項，則將optval指向非零整形數；禁止一個(gè)選項optval指向一個(gè)等于零的整形數。對于布爾型選項，optlen應等于sizeof(int)；對其他選項，optval指向包含所需選項的整形數或結構，而optlen則為整形數或結構的長(cháng)度。SO_LINGER選項用于控制下述情況的行動(dòng)：套接口上有排隊的待發(fā)送數據，且closesocket()調用已執行。參見(jiàn)closesocket()函數中關(guān)于SO_LINGER選項對closesocket()語(yǔ)義的影響。應用程序通過(guò)創(chuàng )建一個(gè)linger結構來(lái)設置相應的操作特性：
struct linger {
int l_onoff;
int l_linger;
};
為了允許SO_LINGER，應用程序應將l_onoff設為非零，將l_linger設為零或需要的超時(shí)值（以秒為單位），然后調用setsockopt()。為了允許SO_DONTLINGER（亦即禁止SO_LINGER），l_onoff應設為零，然后調用setsockopt()。
缺省條件下，一個(gè)套接口不能與一個(gè)已在使用中的本地地址捆綁（參見(jiàn)bind()）。但有時(shí)會(huì )需要“重用”地址。因為每一個(gè)連接都由本地地址和遠端地址的組合唯一確定，所以只要遠端地址不同，兩個(gè)套接口與一個(gè)地址捆綁并無(wú)大礙。為了通知WINDOWS套接口實(shí)現不要因為一個(gè)地址已被一個(gè)套接口使用就不讓它與另一個(gè)套接口捆綁，應用程序可在bind()調用前先設置SO_REUSEADDR選項。請注意僅在bind()調用時(shí)該選項才被解釋?zhuān)还蚀藷o(wú)需（但也無(wú)害）將一個(gè)不會(huì )共用地址的套接口設置該選項，或者在bind()對這個(gè)或其他套接口無(wú)影響情況下設置或清除這一選項。
一個(gè)應用程序可以通過(guò)打開(kāi)SO_KEEPALIVE選項，使得WINDOWS套接口實(shí)現在TCP連接情況下允許使用“保持活動(dòng)”包。一個(gè)WINDOWS套接口實(shí)現并不是必需支持“保持活動(dòng)”，但是如果支持的話(huà)，具體的語(yǔ)義將與實(shí)現有關(guān)，應遵守RFC1122“Internet主機要求－通訊層”中第4.2.3.6節的規范。如果有關(guān)連接由于“保持活動(dòng)”而失效，則進(jìn)行中的任何對該套接口的調用都將以WSAENETRESET錯誤返回，后續的任何調用將以WSAENOTCONN錯誤返回。
TCP_NODELAY選項禁止Nagle算法。Nagle算法通過(guò)將未確認的數據存入緩沖區直到蓄足一個(gè)包一起發(fā)送的方法，來(lái)減少主機發(fā)送的零碎小數據包的數目。但對于某些應用來(lái)說(shuō)，這種算法將降低系統性能。所以TCP_NODELAY可用來(lái)將此算法關(guān)閉。應用程序編寫(xiě)者只有在確切了解它的效果并確實(shí)需要的情況下，才設置TCP_NODELAY選項，因為設置后對網(wǎng)絡(luò )性能有明顯的負面影響。TCP_NODELAY是唯一使用IPPROTO_TCP層的選項，其他所有選項都使用SOL_SOCKET層。
如果設置了SO_DEBUG選項，WINDOWS套接口供應商被鼓勵（但不是必需）提供輸出相應的調試信息。但產(chǎn)生調試信息的機制以及調試信息的形式已超出本規范的討論范圍。
setsockopt()支持下列選項。其中“類(lèi)型”表明optval所指數據的類(lèi)型。
選項 類(lèi)型 意義
SO_BROADCAST BOOL 允許套接口傳送廣播信息。
SO_DEBUG BOOL 記錄調試信息。
SO_DONTLINER BOOL 不要因為數據未發(fā)送就阻塞關(guān)閉操作。設置本選項相當于將SO_LINGER的l_onoff元素置為零。
SO_DONTROUTE BOOL 禁止選徑；直接傳送。
SO_KEEPALIVE BOOL 發(fā)送“保持活動(dòng)”包。
SO_LINGER struct linger FAR* 如關(guān)閉時(shí)有未發(fā)送數據，則逗留。
SO_OOBINLINE BOOL 在常規數據流中接收帶外數據。
SO_RCVBUF int 為接收確定緩沖區大小。
SO_REUSEADDR BOOL 允許套接口和一個(gè)已在使用中的地址捆綁（參見(jiàn)bind()）。
SO_SNDBUF int 指定發(fā)送緩沖區大小。
TCP_NODELAY BOOL 禁止發(fā)送合并的Nagle算法。
setsockopt()不支持的BSD選項有：
選項名 類(lèi)型 意義
SO_ACCEPTCONN BOOL 套接口在監聽(tīng)。
SO_ERROR int 獲取錯誤狀態(tài)并清除。
SO_RCVLOWAT int 接收低級水印。
SO_RCVTIMEO int 接收超時(shí)。
SO_SNDLOWAT int 發(fā)送低級水印。
SO_SNDTIMEO int 發(fā)送超時(shí)。
SO_TYPE int 套接口類(lèi)型。
IP_OPTIONS 在IP頭中設置選項。
返回值：
若無(wú)錯誤發(fā)生，setsockopt()返回0。否則的話(huà)，返回SOCKET_ERROR錯誤，應用程序可通過(guò)WSAGetLastError()獲取相應錯誤代碼。
錯誤代碼：
WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN：WINDOWS套接口實(shí)現檢測到網(wǎng)絡(luò )子系統失效。
WSAEFAULT：optval不是進(jìn)程地址空間中的一個(gè)有效部分。
WSAEINPROGRESS：一個(gè)阻塞的WINDOWS套接口調用正在運行中。
WSAEINVAL：level值非法，或optval中的信息非法。
WSAENETRESET：當SO_KEEPALIVE設置后連接超時(shí)。
WSAENOPROTOOPT：未知或不支持選項。其中，SOCK_STREAM類(lèi)型的套接口不支持SO_BROADCAST選項，SOCK_DGRAM類(lèi)型的套接口不支持SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項。
WSAENOTCONN：當設置SO_KEEPALIVE后連接被復位。
WSAENOTSOCK：描述字不是一個(gè)套接口。
參見(jiàn)：
bind(), getsockopt(), ioctlsocket(), socket(), WSAAsyncSelect().
ioctlsocket() | 簡(jiǎn)述:
控制套接口的模式。
#include <winsock.h>
int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR* argp);
s：一個(gè)標識套接口的描述字。
cmd：對套接口s的操作命令。
argp：指向cmd命令所帶參數的指針。
注釋?zhuān)?br> 本函數可用于任一狀態(tài)的任一套接口。它用于獲取與套接口相關(guān)的操作參數，而與具體協(xié)議或通訊子系統無(wú)關(guān)。支持下列命令：
FIONBIO：允許或禁止套接口s的非阻塞模式。argp指向一個(gè)無(wú)符號長(cháng)整型。如允許非阻塞模式則非零，如禁止非阻塞模式則為零。當創(chuàng )建一個(gè)套接口時(shí)，它就處于阻塞模式（也就是說(shuō)非阻塞模式被禁止）。這與BSD套接口是一致的。WSAAsynSelect()函數將套接口自動(dòng)設置為非阻塞模式。如果已對一個(gè)套接口進(jìn)行了WSAAsynSelect() 操作，則任何用ioctlsocket()來(lái)把套接口重新設置成阻塞模式的試圖將以WSAEINVAL失敗。為了把套接口重新設置成阻塞模式，應用程序必須首先用WSAAsynSelect()調用（IEvent參數置為0）來(lái)禁至WSAAsynSelect()。
FIONREAD：確定套接口s自動(dòng)讀入的數據量。argp指向一個(gè)無(wú)符號長(cháng)整型，其中存有ioctlsocket()的返回值。如果s是SOCKET_STREAM類(lèi)型，則FIONREAD返回在一次recv()中所接收的所有數據量。這通常與套接口中排隊的數據總量相同。如果S是SOCK_DGRAM 型，則FIONREAD返回套接口上排隊的第一個(gè)數據報大小。
SIOCATMARK：確實(shí)是否所有的帶外數據都已被讀入。這個(gè)命令僅適用于SOCK_STREAM類(lèi)型的套接口，且該套接口已被設置為可以在線(xiàn)接收帶外數據（SO_OOBINLINE）。如無(wú)帶外數據等待讀入，則該操作返回TRUE真。否則的話(huà)返回FALSE假，下一個(gè)recv()或recvfrom()操作將檢索“標記”前一些或所有數據。應用程序可用SIOCATMARK操作來(lái)確定是否有數據剩下。如果在“緊急”（帶外）數據前有常規數據，則按序接收這些數據（請注意，recv()和recvfrom()操作不會(huì )在一次調用中混淆常規數據與帶外數據）。argp指向一個(gè)BOOL型數，ioctlsocket()在其中存入返回值。
兼容性：
本函數為Berkeley套接口函數ioctl()的一個(gè)子集。其中沒(méi)有與FIOASYNC等價(jià)的命令，SIOCATMARK是套接口層次支持的唯一命令。
返回值：
成功后，ioctlsocket()返回0。否則的話(huà)，返回SOCKET_ERROR錯誤，應用程序可通過(guò)WSAGetLastError()獲取相應錯誤代碼。
錯誤代碼：
WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN：WINDOWS套接口實(shí)現檢測到網(wǎng)絡(luò )子系統失效。
WSAEINVAL：cmd為非法命令，或者argp所指參數不適用于該cmd命令，或者該命令
不適用于此種類(lèi)型的套接口。
WSAEINPROGRESS：一個(gè)阻塞的WINDOWS套接口調用正在運行中。
WSAENOTSOCK：描述字不是一個(gè)套接口。
參見(jiàn)：
socket(), setsockopt(), getsockopt(), WSAAsyncSelect(). | |
