windows網路程式設計之組播
阿新 • • 發佈：2019-02-12
設定套介面的選項。
#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選項用於控制下述情況的行動：套介面上有排隊的待發送資料，且 closesocket()呼叫已執行。參見closesocket()函式中關於SO_LINGER選項對closesocket()語義的影響。應用 程式通過建立一個linger結構來設定相應的操作特性：
struct linger {
int l_onoff;
int l_linger;
};
為了允許SO_LINGER，應用程式應將l_onoff設為非零，將l_linger設為零或需要的超時值（以秒為單位），然後呼叫setsockopt
預設條件下，一個套介面不能與一個已在使用中的本地地址捆綁（參見bind()）。但有時會需要“重用”地址。因為每一個連線都由本地地址和遠端地址的組 合唯一確定，所以只要遠端地址不同，兩個套介面與一個地址捆綁並無大礙。為了通知WINDOWS套介面實現不要因為一個地址已被一個套介面使用就不讓它與 另一個套介面捆綁，應用程式可在bind()呼叫前先設定SO_REUSEADDR選項。請注意僅在bind()呼叫時該選項才被解釋；故此無需（但也無 害）將一個不會共用地址的套介面設定該選項，或者在bind()對這個或其他套介面無影響情況下設定或清除這一選項。
一個應用程式可以通過開啟SO_KEEPALIVE選項，使得WINDOWS套介面實現在TCP連線情況下允許使用“保持活動”包。一個WINDOWS套 介面實現並不是必需支援“保持活動”，但是如果支援的話，具體的語義將與實現有關，應遵守RFC1122“Internet主機要求－通訊層”中第 4.2.3.6節的規範。如果有關連線由於“保持活動”而失效，則進行中的任何對該套介面的呼叫都將以WSAENETRESET錯誤返回，後續的任何呼叫 將以WSAENOTCONN錯誤返回。
TCP_NODELAY選項禁止Nagle
如果設定了SO_DEBUG選項，WINDOWS套介面供應商被鼓勵（但不是必需）提供輸出相應的除錯資訊。但產生除錯資訊的機制以及除錯資訊的形式已超出本規範的討論範圍。
setsockopt
選項 型別 意義
SO_BROADCAST BOOL 允許套介面傳送廣播資訊。
SO_DEBUG BOOL 記錄除錯資訊。
SO_DONTLINER BOOL 不要因為資料未傳送就阻塞關閉操作。設定本選項相當於將SO_LINGER的l_onoff元素置為零。
SO_DONTROUTE BOOL 禁止選徑；直接傳送。
SO_KEEPALIVE BOOL 傳送“保持活動”包。
SO_LINGER struct linger FAR* 如關閉時有未傳送資料，則逗留。
SO_OOBINLINE BOOL 在常規資料流中接收帶外資料。
SO_RCVBUF int 為接收確定緩衝區大小。
SO_REUSEADDR BOOL 允許套介面和一個已在使用中的地址捆綁（參見bind()）。
SO_SNDBUF int 指定傳送緩衝區大小。
TCP_NODELAY BOOL 禁止傳送合併的Nagle演算法。
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_KEEPALIVE設定後連線超時。
WSAENOPROTOOPT：未知或不支援選項。其中，SOCK_STREAM型別的套介面不支援SO_BROADCAST選項，SOCK_DGRAM 型別的套介面不支援SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項。
WSAENOTCONN：當設定SO_KEEPALIVE後連線被複位。
WSAENOTSOCK：描述字不是一個套介面。
#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選項用於控制下述情況的行動：套介面上有排隊的待發送資料，且 closesocket()呼叫已執行。參見closesocket()函式中關於SO_LINGER選項對closesocket()語義的影響。應用 程式通過建立一個linger結構來設定相應的操作特性：
struct linger {
int l_onoff;
int l_linger;
};
為了允許SO_LINGER，應用程式應將l_onoff設為非零，將l_linger設為零或需要的超時值（以秒為單位），然後呼叫setsockopt
預設條件下，一個套介面不能與一個已在使用中的本地地址捆綁（參見bind()）。但有時會需要“重用”地址。因為每一個連線都由本地地址和遠端地址的組 合唯一確定，所以只要遠端地址不同，兩個套介面與一個地址捆綁並無大礙。為了通知WINDOWS套介面實現不要因為一個地址已被一個套介面使用就不讓它與 另一個套介面捆綁，應用程式可在bind()呼叫前先設定SO_REUSEADDR選項。請注意僅在bind()呼叫時該選項才被解釋；故此無需（但也無 害）將一個不會共用地址的套介面設定該選項，或者在bind()對這個或其他套介面無影響情況下設定或清除這一選項。
一個應用程式可以通過開啟SO_KEEPALIVE選項，使得WINDOWS套介面實現在TCP連線情況下允許使用“保持活動”包。一個WINDOWS套 介面實現並不是必需支援“保持活動”，但是如果支援的話，具體的語義將與實現有關，應遵守RFC1122“Internet主機要求－通訊層”中第 4.2.3.6節的規範。如果有關連線由於“保持活動”而失效，則進行中的任何對該套介面的呼叫都將以WSAENETRESET錯誤返回，後續的任何呼叫 將以WSAENOTCONN錯誤返回。
TCP_NODELAY選項禁止Nagle
如果設定了SO_DEBUG選項，WINDOWS套介面供應商被鼓勵（但不是必需）提供輸出相應的除錯資訊。但產生除錯資訊的機制以及除錯資訊的形式已超出本規範的討論範圍。
setsockopt
選項 型別 意義
SO_BROADCAST BOOL 允許套介面傳送廣播資訊。
SO_DEBUG BOOL 記錄除錯資訊。
SO_DONTLINER BOOL 不要因為資料未傳送就阻塞關閉操作。設定本選項相當於將SO_LINGER的l_onoff元素置為零。
SO_DONTROUTE BOOL 禁止選徑；直接傳送。
SO_KEEPALIVE BOOL 傳送“保持活動”包。
SO_LINGER struct linger FAR* 如關閉時有未傳送資料，則逗留。
SO_OOBINLINE BOOL 在常規資料流中接收帶外資料。
SO_RCVBUF int 為接收確定緩衝區大小。
SO_REUSEADDR BOOL 允許套介面和一個已在使用中的地址捆綁（參見bind()）。
SO_SNDBUF int 指定傳送緩衝區大小。
TCP_NODELAY BOOL 禁止傳送合併的Nagle演算法。
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_KEEPALIVE設定後連線超時。
WSAENOPROTOOPT：未知或不支援選項。其中，SOCK_STREAM型別的套介面不支援SO_BROADCAST選項，SOCK_DGRAM 型別的套介面不支援SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項。
WSAENOTCONN：當設定SO_KEEPALIVE後連線被複位。
WSAENOTSOCK：描述字不是一個套介面。