WSADATA 結構

發行項
02/28/2013

WSADATA結構用來儲存 Windows 通訊端初始化資訊的呼叫所傳回的AfxSocketInit全域函式。

struct WSAData {
   WORD wVersion;
   WORD wHighVersion;
   char szDescription[WSADESCRIPTION_LEN+1];
   char szSystemStatus[WSASYSSTATUS_LEN+1];
   unsigned short iMaxSockets;
   unsigned short iMaxUdpDg;
   char FAR * lpVendorInfo;
};

參數

wVersion
Windows 通訊端 DLL 期望呼叫使用版本的 Windows 通訊端規格。
wHighVersion
這個 DLL 可以支援 (也編碼與以上所述的) Windows 通訊端規格的最高的版本。一般情況下，這等同於 wVersion。
szDescription
Null 結尾的 ASCII 字串 Windows 通訊端 DLL 會描述 Windows 通訊端實作中，其中包括廠商識別碼複製到其中。文字 (最多 256 個字元的長度) 可以包含任何字元，但是廠商會針對包含控制項和格式化字元 cautioned: 應用程式將會以放置這很可能是使用以顯示它 (可能是截斷) 處於的狀態訊息。
szSystemStatus
Null 結尾的 ASCII 字串 Windows 通訊端 DLL 會相關的狀態或組態資訊複製到其中。 Windows 通訊端 DLL 可能會很有幫助使用者的資訊，或支援人員；如果應該使用這個欄位不應該考慮的副檔名為 szDescription 欄位。
iMaxSockets
通訊端的單一處理程序會潛在地讓最大數目。 Windows 通訊端實作可以提供通用的通訊端集區配置到任何程序。此外，它可以配置每個處理序資源的通訊端。數字也會反映 Windows 通訊端 DLL 或網路軟體已設定的方式。應用程式撰寫者可以使用這個數字，做為粗糙表示 Windows 通訊端實作是否可由應用程式。例如，檢查 X Windows 伺服器可能會 iMaxSockets 第一次啟動：如果是小於 8，應用程式會顯示錯誤訊息指示使用者重新設定網路軟體。 (這是在其中的情況下 szSystemStatus 可能會使用文字。)花招，只不過是特定的應用程式可以實際配置不能保證 iMaxSockets 通訊端，因為可能有其他的 Windows 通訊端應用程式使用中。
iMaxUdpDg
以位元組為單位之最大的使用者資料包通訊協定 (UDP) 資料包傳送或接收到的 Windows 通訊端應用程式的大小。如果實作會為沒有限制， iMaxUdpDg 為零。許多柏克萊通訊端的實作，則為隱含的限制 (這進行分段處理，如有必要) 的 UDP 資料包上 8192 位元組。 Windows 通訊端實作也可能造成的限制為基礎，舉個例說，片段重組緩衝區的配置。最小值為 iMaxUdpDg 如相容的 Windows 通訊端實作為 512。請注意，不論值的 iMaxUdpDg，它是 inadvisable 嘗試傳送大於比最大傳輸單位 (MTU) 的網路廣播資料流。 (Windows 通訊端 API 不會提供一個機制，來探索 MTU，但它必須不少於 512 個位元組)。
lpVendorInfo
遠程指標廠商專屬的資料結構。 (如果有提供)，這個結構的定義已超出 Windows 通訊端規格的範圍。

注意事項
在 MFC 中， WSADATA結構傳回的AfxSocketInit函式，您在呼叫程式InitInstance函式。您可以擷取的結構，並將它儲存在您的程式，如果您需要使用稍後再從該資訊。

需求

標頭: winsock2.h

請參閱

參考

AfxSocketInit

其他資源

結構、樣式、回呼和訊息對應

共用方式為

WSADATA 結構

參數

需求

請參閱

參考

其他資源

其他資源