C函数篇（setsockopt函数）
简述
设置套接字的选项。
#include <winsock.h>
int PASCAL FAR setsockopt(SOCKET s,int level,int optname,
const char FAR *optval,int optlen);
s：标识⼀个套接字的描述符。
level：选项定义的层次；⽬前仅⽀持SOL_SOCKET和IPPROTO_TCP层次。
optname：需设置的选项。
optval：，指向存放选项值的。
optlen：optval长度。
注释
setsockopt()⽤于任意类型、任意状态的设置选项值。尽管在不同协议层上存在选项，但本仅定义了最⾼的“”层次上的选项。选项影响的操作，诸如加急数据是否在普通数据流中接收，⼴播数据是否可以从套接⼝发送等等。
有两种的选项：⼀种是布尔型选项，允许或禁⽌⼀种特性；另⼀种是整形或结构选项。允许⼀个布尔型选项，则将optval指向⾮零整形数；禁⽌⼀个选项optval 指向⼀个等于零的整形数。对于布尔型选项，optlen应等于sizeof(int）；对其他选项，optval指向包含所需选项的整形数或结构，⽽ optlen则为整形数或结构的长度。SO_LINGER选项⽤于控制下述情况的⾏动：上有排队的待发送数据，且调⽤已执⾏。参见close（）中关于SO_LINGER选项对closesocket（）语义的影响。
操作特性
通过创建⼀个linger结构来设置相应的操作特性：
struct linger {
int l_onoff;
int l_linger;
};
为了允许SO_LINGER，应将l_onoff设为⾮零，将l_linger设为零或需要的超时值（以秒为单位），然后调⽤setsockopt（）。为了允许
SO_DONTLINGER（亦即禁⽌SO_LINGER），l_onoff应设为零，然后调⽤setsockopt（）。
缺省条件下，⼀个不能与⼀个已在使⽤中的本地地址捆绑（参见）。但有时会需要“重⽤”地址。因为每⼀个连接都由本地地址和远端地址的组合唯⼀确定，所以只要远端地址不同，两个与⼀个地址捆绑并⽆⼤碍。为了通知WINDOWS实现不要因为⼀个地址已被⼀个套接⼝使⽤就不让它与另⼀个套接⼝捆绑，可在bind（）调⽤前先设置SO_REUSEADDR选项。请注意仅在bind（）调⽤时该选项才被解释；故此⽆需（但也⽆害）将⼀个不会共⽤地址的设置该选项，或者在bind（）对这个或其他套接⼝⽆影响情况下设置或清除这⼀选项。
⼀个可以通过打开SO_KEEPALIVE选项，使得WINDOWS实现在TCP连接情况下允许使⽤“保持活动”包。⼀个WINDOWS实现并不是必需⽀持“保持活动”，但是如果⽀持的话，具体的语义将与实现有关，应遵守RFC1122“Internet主机要求－通讯层”中第4.2.3.6节的规范。如果有关连接由于“保持活动”⽽失效，则进⾏中的任何对该的调⽤都将以WSAENETRESET错误返回，后续的任何调⽤将以WSAENOTCONN错误返回。
TCP_NODELAY选项禁⽌。通过将未确认的数据存⼊直到蓄⾜⼀个包⼀起发送的⽅法，来减少主机发送的零碎⼩数据包的数⽬。但对于某些应⽤来说，这种算法将降低系统性能。所以TCP_NODELAY可⽤来将此算法关闭。编写者只有在确切了解它的效果并确实需要的情况下，才设置TCP_NODELAY选项，因为设置后对⽹络性能有明显的负⾯影响。TCP_NODELAY是唯⼀使⽤IPPROTO_TCP层的选项，其他所有选项都使⽤SOL_SOCKET层。
如果设置了SO_DEBUG选项，WINDOWS供应商被⿎励（但不是必需）提供输出相应的调试信息。但产⽣调试信息的机制以及调试信息的形式已超出本规范的讨论范围。
setsockopt（）⽀持下列选项。其中“类型”表明optval所指数据的类型。
选项类型意义
SO_BROADCAST BOOL 允许传送⼴播信息。
SO_DEBUG BOOL 记录调试信息。
SO_DONTLINER BOOL 不要因为数据未发送就阻塞关闭操作。设置本选项相当于将SO_LINGER的l_onoff元素置为零。
SO_DONTROUTE BOOL 禁⽌选径；直接传送。
SO_KEEPALⅣE BOOL 发送“保持活动”包。
SO_LINGER struct linger FAR* 如关闭时有未发送数据，则逗留。
SO_OOBINLINE BOOL 在常规数据流中接收。
SO_RCVBUF int 为接收确定⼤⼩。
SO_REUSEADDR BOOL 允许和⼀个已在使⽤中的地址捆绑（参见bind（））。
SO_SNDBUF int 指定发送⼤⼩。
TCP_NODELAY BOOL 禁⽌发送合并的。
setsockopt（）不⽀持的BSD选项有：
选项名类型意义
SO_ACCEPTCONN BOOL 在监听。
SO_ERROR int 获取错误状态并清除。
SO_RCVLOWAT int 接收低级。
SO_RCVTIMEO int 接收超时。
SO_SNDLOWAT int 发送低级。
SO_SNDTIMEO int 发送超时。
SO_TYPE int 类型。
IP_OPTIONS 在IP头中设置选项。
返回值
若⽆错误发⽣，setsockopt（）返回0。否则的话，返回SOCKET_ERROR错误，可通过WSAGetLastError（）获取相应错误代码。
：
WSANOTINITIALISED：在使⽤此API之前应⾸先成功地调⽤WSAStartup（）。
WSAENETDOWN：WINDOWS实现检测到⽹络⼦系统失效。
WSAEFAULT：optval不是进程中的⼀个有效部分。
WSAEINPROGRESS：⼀个阻塞的WINDOWS调⽤正在运⾏中。
WSAEINVAL：level值⾮法，或optval中的信息⾮法。
WSAENETRESET：当SO_KEEPALⅣE设置后连接超时。
WSAENOPROTOOPT：未知或不⽀持选项。其中，SOCK_STREAM类型的不⽀持SO_BROADCAST选项，SOCK_DGRAM类型的套接⼝不⽀持SO_DONTLINGER 、SO_KEEPALⅣE、SO_LINGER和SO_OOBINLINE选项。
WSAENOTCONN：当设置SO_KEEPALⅣE后连接被复位。
WSAENOTSOCK：描述字不是⼀个。recv函数
⽤法
⒈设置调⽤后，仍可继续重⽤该。调⽤⼀般不会⽴即关闭，⽽经历TIME_WAIT的过程。
BOOL bReuseaddr = TRUE;
setsockopt(s,SOL_SOCKET,,(const char*)&bReuseaddr,sizeof(BOOL));
⒉如果要已经处于连接状态的soket在调⽤close()后强制关闭，不经历TIME_WAIT的过程：
BOOL bDontLinger = FALSE;
setsockopt(s,SOL_SOCKET,SO_DONTLINGER,(const char*)&bDontLinger,sizeof(BOOL));
⒊在(),recv（）过程中有时由于⽹络状况等原因，收发不能预期进⾏，可以设置收发时限：
int nNetTimeout = 1000; //1秒
//发送时限
setsockopt(,SOL_SOCKET,SO_SNDTIMEO,(char *)&nNetTimeout,sizeof(int));
//接收时限
setsockopt(socket,SOL_SOCKET,SO_RCVTIMEO,(char *)&nNetTimeout,sizeof(int));
⒋在()的时候，返回的是实际发送出去的字节（同步）或发送到的字节（异步）；系统默认的状态发送和接收⼀次为8688字节（约
为8.5K）；在实际的过程中如果发送或是接收的数据量⽐较⼤，可以设置，避免(),recv（）不断的循环收发：
// 接收
int nRecvBuf = 32 * 1024; //设置为32K
setsockopt(s,SOL_SOCKET,SO_RCVBUF,(const char*)&nRecvBuf,sizeof(int));
//发送
int nSendBuf = 32*1024; //设置为32K
setsockopt(s,SOL_SOCKET,SO_SNDBUF,(const char*)&nSendBuf,sizeof(int));
⒌在发送数据的时，不执⾏由系统到缓冲区的拷贝，以提⾼程序的性能：
int nZero = 0;
setsockopt(socket,SOL_SOCKET,SO_SNDBUF,(char *)&nZero,sizeof(nZero));
⒍在接收数据时，不执⾏将的内容拷贝到系统缓冲区：
int nZero = 0;
setsockopt(s,SOL_SOCKET,SO_RCVBUF,(char *)&nZero,sizeof(int));
⒎⼀般在发送数据报的时候，希望该发送的数据具有⼴播特性：
BOOL bBroadcast = TRUE;
setsockopt(s,SOL_SOCKET,SO_BROADCAST,(const char*)&bBroadcast,sizeof(BOOL));
⒏在client连接服务器过程中，如果处于⾮阻塞模式下的在()的过程中可以设置（）延时，直到accpet（）被调⽤（此设置只
有在⾮阻塞的过程中有显著的作⽤，在阻塞的中作⽤不⼤）
BOOL bConditionalAccept = TRUE;
setsockopt(s,SOL_SOCKET,SO_CONDITIONAL_ACCEPT,(const char*)&bConditionalAccept,sizeof(BOOL));
⒐如果在发送数据的过程中()没有完成，还有数据没发送，⽽调⽤了close（），以前⼀般采取的措施是(
s,SD_BOTH），但是数
据将会丢失。
某些具体程序要求待未发送完的数据发送出去后再关闭，可通过设置让程序满⾜要求：
1struct linger {
2  u_short l_onoff;
3  u_short l_linger;
4 };
5 linger m_sLinger;
6 m_sLinger.l_onoff = 1;
7//在调⽤closesocket（）时还有数据未发送完，允许等待
8//若m_sLinger.l_onoff=0；则调⽤closesocket（）后强制关闭
9 m_sLinger.l_linger = 5; //设置等待时间为5秒
10 setsockopt(s, SOL_SOCKET, SO_LINGER,
11    (const char*)&m_sLinger,sizeof(linger));

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。