【正文】 ● ?WSANOTINTIALISED：在應(yīng)用這個(gè) API前 ， 必須成功調(diào)用 WSAStartup(?)。 如果函數(shù)調(diào)用失敗 ， 則返回 SOCKET_ERROR錯(cuò)誤信息 。 ● ?namelen：傳入?yún)?shù) ， 緩沖區(qū)的長(zhǎng)度 。 1． 函數(shù)格式 該函數(shù)的格式如下： int gethostname( char FAR* name, int namelen )。 4． 函數(shù)使用說(shuō)明 該函數(shù)的用法參見(jiàn)第 7章中的服務(wù)器程序?qū)嵗?。 第 8章 Winsock API 3． 函數(shù)返回信息 該函數(shù)調(diào)用成功后 ， 返回一個(gè)指向字符的指針 ，該指針指向一個(gè)文本型的緩沖區(qū) ， 緩沖區(qū)中存有用點(diǎn)分十進(jìn)制形式表示的 IP地址 。 第 8章 Winsock API 網(wǎng)絡(luò)字節(jié)順序的 IP地址轉(zhuǎn)換為點(diǎn)分十進(jìn)制數(shù)表示的 IP地址 —— i_ntoa(?) 1． 函數(shù)格式 i_ntoa(?)函數(shù)的格式如下： char *i_ntoa( struct in_addr in )。 (4) a：對(duì)于一個(gè)僅有一個(gè)部分的 IP地址 ， 將它的值直接存入網(wǎng)絡(luò)地址而不做任何字節(jié)重組 。 第 8章 Winsock API (2) ：對(duì)于一個(gè)只有三個(gè)部分組成的 IP地址 ， 最后一部分被解釋成 16位數(shù)據(jù) ， 并作為網(wǎng)絡(luò)地址最右邊的兩個(gè)字節(jié) 。 請(qǐng)注意 ， 當(dāng)一個(gè) Inter地址在 Intel機(jī)器上表示成一個(gè) 32位整型數(shù)時(shí) ， 則上述數(shù)據(jù)在計(jì)算機(jī)內(nèi)部的表示為 “ ”。 第 8章 Winsock API 4． 函數(shù)使用說(shuō)明 當(dāng) IP地址用點(diǎn)分十進(jìn)制數(shù)表示時(shí) ， 即 4個(gè)字節(jié)的數(shù)以“ .”間隔 ， 則用這種格式書(shū)寫(xiě)的 IP地址可有下列 4種表示方式 。 3． 函數(shù)返回信息 該函數(shù)調(diào)用成功后 ， 返回一個(gè)無(wú)符號(hào)長(zhǎng)整型數(shù)(Unsigned Long)， 它是以網(wǎng)絡(luò)字節(jié)順序表示的 32位二進(jìn)制IP地址 。 第 8章 Winsock API IP地址轉(zhuǎn)換函數(shù) 點(diǎn)分十進(jìn)制數(shù)表示的 IP地址轉(zhuǎn)換為網(wǎng)絡(luò)字節(jié)順序的 IP地址 —— i_addr(?) 1． 函數(shù)格式 i_addr(?)函數(shù)的格式如下： unsigned long i_addr( const char FAR* cp )。 具體錯(cuò)誤代碼與 WSAHtonl(?)函數(shù)的錯(cuò)誤代碼類(lèi)似 。 WSANtohs(?)函數(shù)在調(diào)用正確時(shí)返回 0， 函數(shù)返回的16位主機(jī)字節(jié)順序的數(shù)據(jù)是指針參數(shù) lphostshort所指向的數(shù) 。 ● ?lphostshort：傳出參數(shù)，指向一個(gè) 16位主機(jī)字節(jié)順序數(shù)的指針。 第 8章 Winsock API 2． 函數(shù)參數(shù)說(shuō)明 這兩個(gè)函數(shù)的參數(shù)說(shuō)明如下： ● ?short：傳入?yún)?shù) ， 一個(gè)以網(wǎng)絡(luò)字節(jié)順序表示的 16位數(shù) 。 第 8章 Winsock API 2字節(jié)網(wǎng)絡(luò)字節(jié)順序的數(shù)轉(zhuǎn)化為主機(jī)字節(jié)順序 ——ntohs(?)和 WSANtohs(?) 1． 函數(shù)格式 在 Winsock 1中提供的 ntohs(?)函數(shù)的格式是： u_short ntohs( u_short short )。 具體錯(cuò)誤代碼與 WSAHtonl(?)函數(shù)的錯(cuò)誤代碼類(lèi)似 。 第 8章 Winsock API WSANtohl(?)函數(shù)在調(diào)用正確時(shí)返回 0， 函數(shù)返回的 32位主機(jī)字節(jié)順序的數(shù)據(jù)是指針參數(shù) lphostlong所指向的數(shù) 。 ● ?lphostlong：傳出參數(shù) ， 指向一個(gè) 32位主機(jī)字節(jié)順序數(shù)的指針 。 第 8章 Winsock API 2． 函數(shù)參數(shù)說(shuō)明 這兩個(gè)函數(shù)的參數(shù)說(shuō)明如下： ● ?long：傳入?yún)?shù) ， 一個(gè)以網(wǎng)絡(luò)字節(jié)順序表示的 32位數(shù) 。 第 8章 Winsock API 4字節(jié)網(wǎng)絡(luò)字節(jié)順序的數(shù)轉(zhuǎn)化為主機(jī)字節(jié)順序 ——ntohl(?)和 WSANtohl(?) 1． 函數(shù)格式 在 Winsock 1中提供的 ntohl(?)函數(shù)的格式是： u_long ntohl( u_long long )。 錯(cuò)誤代碼與 WSAHtonl(?)函數(shù)的錯(cuò)誤代碼類(lèi)似 。 WSAHtons(?)函數(shù)如果被調(diào)用時(shí)正確執(zhí)行 ， 則這個(gè)函數(shù)返回 0， 函數(shù)返回的 16位網(wǎng)絡(luò)字節(jié)順序的數(shù)據(jù)是指針參數(shù)lpshort所指向的數(shù) 。 ● ?lpshort：傳出參數(shù) ， 一個(gè)指向 16位網(wǎng)絡(luò)字節(jié)順序數(shù)的指針 。 第 8章 Winsock API 2． 函數(shù)參數(shù)說(shuō)明 這兩個(gè)函數(shù)中各參數(shù)的說(shuō)明如下： ● ?hostshort：傳入?yún)?shù) ， 它是一個(gè)以主機(jī)字節(jié)順序表示的將要被轉(zhuǎn)換為網(wǎng)絡(luò)字節(jié)順序的 16位數(shù) (即 2字節(jié)數(shù) )， u_short表示無(wú)符號(hào)短整型數(shù) 。 第 8章 Winsock API 2字節(jié)主機(jī)字節(jié)順序的數(shù)轉(zhuǎn)化為網(wǎng)絡(luò)字節(jié)順序 ——htons(?)和 WSAHtons(?) 1． 函數(shù)格式 在 Winsock 1中提供的 htons(?)函數(shù)的格式是： u_short htons( u_short hostshort )。 ● ?WSAEFAULT：指針參數(shù) lplong不在有效的用戶地址空間中 。 ● ?WSAENETDOWN：網(wǎng)絡(luò)子系統(tǒng)失效 。 如果在調(diào)用時(shí)該函數(shù)發(fā)生錯(cuò)誤 ， 則返回 SOCKET_ERROR錯(cuò)誤信息 ， 可以進(jìn)一步使用 WSAGetLastError(?)函數(shù)取得對(duì)該錯(cuò)誤的具體描述 。 對(duì)于 htonl(?)函數(shù)來(lái)說(shuō) ， 如果該函數(shù)被調(diào)用時(shí)正確執(zhí)行 ，則這個(gè)函數(shù)返回一個(gè) 32位的 TCP/IP網(wǎng)絡(luò)字節(jié)順序的數(shù) 。 ● ?lplong：傳出參數(shù) ， 一個(gè)指向 32位的網(wǎng)絡(luò)字節(jié)順序數(shù)的指針 。 2． 函數(shù)參數(shù)說(shuō)明 這兩個(gè)函數(shù)中各參數(shù)的說(shuō)明如下： ● ?hostlong：傳入?yún)?shù) ， 它是一個(gè)用主機(jī)字節(jié)順序表示的將要被轉(zhuǎn)換為網(wǎng)絡(luò)字節(jié)順序的 32位數(shù) (即 4個(gè)字節(jié)的數(shù) )，u_long表示無(wú)符號(hào)長(zhǎng)整型數(shù) 。第 8章 Winsock API 第 8章 Winsock API 字節(jié)排序函數(shù) IP地址轉(zhuǎn)換函數(shù) 網(wǎng)絡(luò)信息獲取函數(shù) (數(shù)據(jù)庫(kù)函數(shù) ) 套接口選項(xiàng)函數(shù) 套接口 I/O處理函數(shù) 事件對(duì)象 I/O管理 錯(cuò)誤處理函數(shù) Winsock 2支持的其他函數(shù) 習(xí)題 第 8章 Winsock API 4字節(jié)主機(jī)字節(jié)順序的數(shù)轉(zhuǎn)化為網(wǎng)絡(luò)字節(jié)順序 ——htonl(?)和 WSAHtonl(?) 1． 函數(shù)格式 在 Winsock 1中提供的 htonl(?)函數(shù)的格式是： u_long htonl( u_long hostlong )。 在 Winsock 2中提供的 WSAHtonl(?)函數(shù)的擴(kuò)展格式是： 第 8章 Winsock API int WSAHtonl( SOCKET s, u_long hostlong, u_long FAR * lplong )。 ● ?s：傳入?yún)?shù) ， 在 Winsock 2提供的擴(kuò)展格式中增加了標(biāo)識(shí)套接口的描述字 。 第 8章 Winsock API 3． 函數(shù)返回信息 這兩個(gè)函數(shù)的返回值差別較大 ， 在使用時(shí)一定要注意 。 對(duì)于 WSAHtonl(?)函數(shù)來(lái)說(shuō) ， 如果該函數(shù)被調(diào)用時(shí)正確執(zhí)行 ， 則這個(gè)函數(shù)的返回值為 0， 函數(shù)返回的 32位網(wǎng)絡(luò)字節(jié)順序的數(shù)據(jù)是指針參數(shù) lplong所指向的數(shù) 。 錯(cuò)誤代碼如下： 第 8章 Winsock API ● ?WSANOTINITIALISED：在調(diào)用本 API之前應(yīng)成功調(diào)用 WSAStartup(?)。 ● ?WSAENOTSOCK：描述字不是一個(gè)套接口 。 4． 函數(shù)使用說(shuō)明 該函數(shù)的使用比較簡(jiǎn)單 ， 主要用來(lái)將一個(gè) 32位的 IP地址從主機(jī)字節(jié)順序轉(zhuǎn)化為網(wǎng)絡(luò)字節(jié)順序 ， 具體用法可以參考第 7章的網(wǎng)絡(luò)程序?qū)嵗?。 在 Winsock 2中提供的 WSAHtons(?)函數(shù)的擴(kuò)展格式是： u_short WSAHtons( SOCKET s, u_short hostshort, u_short FAR * lpshort )。 ● ?s：傳入?yún)?shù) ， Winsock 2提供的擴(kuò)展格式中增加的標(biāo)識(shí)套接口的描述字 。 第 8章 Winsock API 3． 函數(shù)返回信息 htons(?)函數(shù)如果被調(diào)用時(shí)正確執(zhí)行 ， 則這個(gè)函數(shù)返回一個(gè) 16位 TCP/IP網(wǎng)絡(luò)字節(jié)順序的數(shù) 。 如果在調(diào)用時(shí)該函數(shù)發(fā)生錯(cuò)誤 ， 則返回 SOCKET_ERROR 錯(cuò)誤信息 ， 可 以 進(jìn) 一 步 使 用WSAGetLastError(?)函數(shù)取得對(duì)該錯(cuò)誤的具體描述 。 4． 函數(shù)使用說(shuō)明 該函數(shù)一般用來(lái)將一個(gè) 16位的 TCP或 UDP端口號(hào)從主機(jī)字節(jié)順序轉(zhuǎn)化為網(wǎng)絡(luò)字節(jié)順序，用法可以參考第 7章的程序?qū)嵗? 在 Winsock 2中提供的 WSANtohl(?)函數(shù)的擴(kuò)展格式是： u_long WSANtohl( SOCKET s, u_long long, u_long FAR * lphostlong )。 ● ?s：傳入?yún)?shù) ， 在 Winsock 2中提供的擴(kuò)充格式中增加的標(biāo)識(shí)套接口的描述字 。 3． 函數(shù)返回信息 ntohl(?)函數(shù)在調(diào)用成功后 ， 返回一個(gè)主機(jī)字節(jié)順序的 32位數(shù) 。如果調(diào)用錯(cuò)誤 ， 則返回錯(cuò)誤信息 SOCKET_ERROR， 可以進(jìn)一步使用 WSAGetLastError(?)函數(shù)取得對(duì)該錯(cuò)誤的具體描述 。 4． 函數(shù)使用說(shuō)明 該函數(shù)常用來(lái)將一個(gè)網(wǎng)絡(luò)字節(jié)順序表示的 32位 IP地址轉(zhuǎn)化為主機(jī)字節(jié)順序 。 在 Winsock 2中提供的 WSANtohs(?)函數(shù)的擴(kuò)展格式是： u_short WSANtohs( SOCKET s, u_short short, u_short FAR * lphostshort )。 ● ?s：傳入?yún)?shù) ， 在 Winsock 2提供的擴(kuò)充格式中增加的一個(gè)標(biāo)識(shí)套接口的描述字 。 第 8章 Winsock API 3． 函數(shù)返回信息 ntohs(?)函數(shù)在調(diào)用成功后 ， 返回一個(gè)主機(jī)字節(jié)順序的 16位數(shù) 。 如果調(diào)用錯(cuò)誤 ， 則返回錯(cuò)誤信息 SOCKET_ERROR，可以進(jìn)一步使用 WSAGetLastError(?)函數(shù)取得對(duì)該錯(cuò)誤的具體描述 。 4． 函數(shù)使用說(shuō)明 該函數(shù)常用來(lái)將一個(gè)網(wǎng)絡(luò)字節(jié)順序表示的 16位 TCP或UDP端口號(hào)轉(zhuǎn)化為主機(jī)字節(jié)順序 。 第 8章 Winsock API 2． 函數(shù)參數(shù)說(shuō)明 該函數(shù)中的參數(shù) cp為傳入?yún)?shù) ， 是一個(gè)以 “ .”間隔的字符串 ， 即一個(gè)點(diǎn)分十進(jìn)制數(shù)表示的 IP地址 。 如果傳入的字符串不是一個(gè)合法的 Inter地址 ，如當(dāng) “ ”地址中任一項(xiàng)超過(guò) 255時(shí) ， 則 i_addr(?)返回INADDR_NONE提示信息 。 (1) ?：當(dāng)四個(gè)部分都有固定的值時(shí) ， 則每一個(gè)部分被解釋成一個(gè)字節(jié)的數(shù)據(jù) ， 從左到右組成 Inter 4字節(jié)地址 。 這是因?yàn)樵?Intel處理器內(nèi)部 ， 字中的字節(jié)是按由低到高的順序存儲(chǔ)的 ， 即 “ 小序在前 ” 。 (3) ：對(duì)于一個(gè)只有兩個(gè)部分組成的 IP地址 ， 最后一部分解釋成 24位數(shù)據(jù) ， 并作為網(wǎng)絡(luò)地址最右邊的三個(gè)字節(jié) 。 該函數(shù)的用法見(jiàn)第 7章中的客戶程序?qū)嵗? 2． 函數(shù)參數(shù)說(shuō)明 該函數(shù)中的參數(shù) in為傳入?yún)?shù)，表示一個(gè)結(jié)構(gòu)型的IP主機(jī)地址。 如果函數(shù)調(diào)用失敗的話 ，則返回一個(gè)空指針 (NULL)。 第 8章 Winsock API 網(wǎng)絡(luò)信息獲取函數(shù) (數(shù)據(jù)庫(kù)函數(shù) ) 獲得主機(jī)名 —— gethostname(?) gethostname(?)函數(shù)用來(lái)取得一臺(tái)主機(jī)的名稱信息 。 第 8章 Winsock API 2． 函數(shù)參數(shù)說(shuō)明 gethostname(?)函數(shù)中各參數(shù)的說(shuō)明如下： ● ?name：傳出參數(shù) ， 一個(gè)指向?qū)⒁娣胖鳈C(jī)名的緩沖區(qū)指針 ， 當(dāng)函數(shù)調(diào)用完成時(shí) ， 主機(jī)名被存入該緩沖區(qū)中 。 3． 函數(shù)返回信息 如果函數(shù)調(diào)用時(shí)沒(méi)有發(fā)生錯(cuò)誤 ， 則 gethostname