TCP IP协议与网络编程 任泰明 第8章 Winsock API.pptVIP

第8章 Winsock API 8.1 字节排序函数 8.2 IP地址转换函数 8.3 网络信息获取函数(数据库函数) 8.4 套接口选项函数 8.5 套接口I/O处理函数 8.6 事件对象I/O管理 8.7 错误处理函数 8.8 Winsock 2支持的其他函数 习题 8.1字节排序函数 8.1.1 4字节主机字节顺序的数转化为网络字节顺序——htonl(?)和WSAHtonl(?) 1．函数格式 在Winsock 1中提供的htonl(?)函数的格式是： u_long htonl( u_long hostlong ); 在Winsock 2中提供的WSAHtonl(?)函数的扩展格式是： int WSAHtonl( SOCKET s, u_long hostlong, u_long FAR * lpnetlong ); 2．函数参数说明 这两个函数中各参数的说明如下： ● ?hostlong：传入参数，它是一个用主机字节顺序表示的将要被转换为网络字节顺序的32位数(即4个字节的数)，u_long表示无符号长整型数。 ● ?s：传入参数，在Winsock 2提供的扩展格式中增加了标识套接口的描述字。 ● ?lpnetlong：传出参数，一个指向32位的网络字节顺序数的指针。 3．函数返回信息 这两个函数的返回值差别较大，在使用时一定要注意。 对于htonl(?)函数来说，如果该函数被调用时正确执行，则这个函数返回一个32位的TCP/IP网络字节顺序的数。 对于WSAHtonl(?)函数来说，如果该函数被调用时正确执行，则这个函数的返回值为0，函数返回的32位网络字节顺序的数据是指针参数lpnetlong所指向的数。如果在调用时该函数发生错误，则返回SOCKET_ERROR错误信息，可以进一步使用WSAGetLastError(?)函数取得对该错误的具体描述。错误代码如下： ● ?WSANOTINITIALISED：在调用本API之前应成功调用WSAStartup(?)。 ● ?WSAENETDOWN：网络子系统失效。 ● ?WSAENOTSOCK：描述字不是一个套接口。 ● ?WSAEFAULT：指针参数lpnetlong不在有效的用户地址空间中。 4．函数使用说明 该函数的使用比较简单，主要用来将一个32位的IP地址从主机字节顺序转化为网络字节顺序，具体用法可以参考第7章的网络程序实例。 8.1.2 2字节主机字节顺序的数转化为网络字节顺序——htons(?)和WSAHtons(?) 1．函数格式 在Winsock 1中提供的htons(?)函数的格式是： u_short htons( u_short hostshort ); 在Winsock 2中提供的WSAHtons(?)函数的扩展格式是： u_short WSAHtons( SOCKET s, u_short hostshort, u_short FAR * lpnetshort ); 2．函数参数说明 这两个函数中各参数的说明如下： ● ?hostshort：传入参数，它是一个以主机字节顺序表示的将要被转换为网络字节顺序的16位数(即2字节数)，u_short表示无符号短整型数。 ● ?s：传入参数，Winsock 2提供的扩展格式中增加的标识套接口的描述字。 ● ?lpnetshort：传出参数，一个指向16位网络字节顺序数的指针。 3．函数返回信息 htons(?)函数如果被调用时正确执行，则这个函数返回一个16位TCP/IP网络字节顺序的数。 WSAHtons(?)函数如果被调用时正确执行，则这个函数返回0，函数返回的16位网络字节顺序的数据是指针参数lpnetshort所指向的数。如果在调用时该函数发生错误，则返回SOCKET_ERROR错误信息，可以进一步使用WSAGetLastError(?)函数取得对该错误的具体描述。错误代码与WSAHtonl(?)函数的错误代码类似。 4．函数使用说明 该函数一般用来将一个16位的TCP或UDP端口号从主机字节顺序转化为网络字节顺序，用法可以参考第7章的程序实例。 8.1.3 4字节网络字节顺序的数转化为主机字节顺序——ntohl(?)和WSANtohl(?) 1．函