1.主机名查询函数
gethostname(cha* **R *name,int namelen)
参数说明:
name: char数组
namelen:char数组大小
2.通过主机名查询主机信息
gethostbyname(const cha* **R*name)
WSAAsyncGetHostByName(HWND hWnd,unsigned int wMsg,const cha* **R*name,cha* **R*buf,int buflen)
对于IP地址字符串,函数不能返回正确的主机信息,应使用inet_addr()函数得到相应主机IP地址。
返回结构hostent定义如下
struct hostent{
cha* **R*h_name; //official name of host
cha* ******R*h_aliases; //alias list
short h_addrtype; //host address type
short h_length; //length of address
cha* ******R*h_addr_list; //list of addresses
#define h_addr h_addr_list[0] //address,for backward compat
}
参数说明:
hWnd 异步操作结束后收到消息的窗口句柄
wMsg 异步操作结束后的消息
buf 用于存放协议信息的缓冲区,其大小应大于sizeof(struct protoent),因为不同的WinSock实现,还可能有其他信息,所以建议缓冲区大小为MAXGETHOSTSTRUCT字节
buflen 指buf的字节数
name 与同步操作类似
3.通过地址查询主机信息的函数
gethostbyaddr(const cha* **R*addr,int len,int type)
WSAAsyncGetHostByAddr(HWND hWnd,unsigned int wMsg,const cha* **R*addr,int len,int type,cha* **R*buf,int buflen)
参数说明:
addr 为网络字节序的IP地址
len 指地址长度,对于PF_INET(TCP/IP协议族)必须等于4
type 地址类型,必须为PF_INET
hWnd与wMsg的含义同上
4.通过协议名查询协议信息
getprotobyname(const cha* **R*name)
WSAAsyncGetProtoByName(HWND hWnd,unsigned int wMsg,const FAR*name,cha* **R*buf,int buflen)
参数说明:
name 协议名称,如TCP、UDP等
struct protoent{
cha* **R*p_name; //协议的正式名称
cha* ******R*p_aliases; //以NULL结束的一串协议别名
short p_proto; //协议编号,主机字节序
};
hWnd与wMsg的含义同上
5.通过端口号查询协议信息
getprotobynumber(int number)
WSAAsyncGetProtoByNumber(HWND hWnd,unsigned int wMsg,int number,cha* **R*buf,int buflen)
参数说明:
number 为协议编号
6.通过服务名查询服务信息
getservbyname(const cha* **R*name,const cha* **R*proto)
WSAAsyncGetServByName(HWND hWnd,unsigned int wMsg,const cha* **R*name,const cha* **R*proto,cha* **R*buf,int buflen)
参数说明:
name 服务名称,如FTP、HTTP等
proto 协议名,如TCP、UDP等,也可以为NULL
struct servent{
cha* **R*s_name; //服务的正式名称
cha* ******R*s_aliases; //以NULL为结束标志的一串服务别名
short s_port; //与服务相关联的端口号,网络字节序
cha* **R*s_proto; //用户访问服务时使用的协议
}
7.通过端口查询的服务信息
getservbyport(int port,const cha* **R*proto)
WSAAsyncGetServByPort(HWND hWnd,unsigned int wMsg,int port,const cha* **R*proto,cha* **R*buf,int buflen);
参数说明:
port //端口号
proto //协议名,如TCP、UDP等,也可以为NULL
第二部分 辅助函数
1.字节序处理函数 网络字节顺序
u_short PASCAL htons(u_short hostshort)将16bit的主机字节顺序数据转换成网络字节顺序
u_long PASCAL htonl(u_long hostlong)将32bit的主机字节顺序数据转换成网络字节顺序
u_short PASCAL ntohs(u_short netshort)将16bit的网络字节顺序数据转换成主机字节顺序
u_long PASCAL ntohl(u_long netlong)将32bit的网络字节顺序数据转换成主机字节顺序
2.字节操作函数
#define bcopy(s,d,n) _fmemcpy((d),(s),(n))
#define bcmp(s1,s2,n) _fmemcmp((s1),(s2),(n))
#define bzero(s,n) _fmemset((s),0,(n))
3.地址转换函数
unsigned long PASCAL FAR inet_addr(const cha* **R*cp) //把由数字和小数点组成的字符串转变为32位IP地址(网络字节顺序)
cha* **R*PASCAL FAR inet_ntoa(struct in_addr in) //与上述相反
参数说明:
cp 为小数点分隔的十进制数字表示的IP地址,如202.113.244.6
in 是32bit网络字节顺序的IP地址
4.WinSock的初始化函数WSAStartup和结束函数WSACleanup
(1)int PASCAL FAR WSAStartup(WORD wVersionRequested,LPWSADATA lpWSAData)
参数说明:
wVersionRequested 指应用程序对WinSock版本的要求,它的低字节内容为主版本号,高字节为副版本号。当前为1.1
lpWSAData包含具体WinSock实现的一些信息,定义如下
typedef struct WSAData{ //成功返回零
WORD wVersion;
WORD wHighVersion;
char szDescription[WSADESCRIPTION_LEN+1];
char szSystemStatus[WSASYS_STATUS_LEN+1];
unsigned short iMaxSockets;
unsigned short iMaxUdpDg;
cha* **R*lpVendorInfo;
}WSADATA;
WSAStartup()函数必须在调用其他WinSock函数之前调用,否则,其他函数会返回错误。
典型用法为:
WORD wVersionRequested;
WSADATA wsaData;
int err;
wVersi(1,1);
err=WSAStartup(wVersionRequested,&wsaData);
if(err!=0)
{
//错误处理
return;
{
//如果当前系统的WinSock版本高于1.1,WSAStartup仍然返回1.1
if(LOBYTE(wsaData.wVersion)!=1||HIBYTE(wsaData.wVersion)!=1)
{
//不支持1.1版本
return;
}
(2)int PASCAL FAR WSACleanup(void)
第三部分 WinSock2.0
1.多点通信
WSASocket(
SOCKET s; //地址族
int type; //连接类型
int protocol; //协议类型
LPWSAPROTOCOL_INFO pinfo; //低层协议信息
GROUP g; //套接字组号
DWORD dwFlag; //标志,可以定义为叶节点或根节点
)
WSAJoinLeaf(
SOCKET s; //套接字
sockadd* **R*name; //地址
DWORD namelen; //地址长度
LPWSABUF lpCalleeDATA; //被调用者返回参数
LPWSABUF lpCalleeData; //调用者返回参数
LPQoS lpSQoS; //QoS参数
LPQoS lpGQoS; //QoS参数
DWORD dwFlags; //标志
)
2.WinSock2新增加的函数
函数 说明
WSAAccept accept()函数的扩展版本,支持条件接收和套接字组
WSACloseEvent 释放一个事件对象
WSAConnect connect()函数的扩展版本,支持连接数据交换和QoS规范
WSACreateEvent 创建一个事件对象
WSADuplicateSocket 为一个共享套接字创建一个新的套接字描述符
WSAEnumNetworkEvent 查询是否有网络事件发生
WSAEnumProtocols 获得所有协议的信息
WSAEventSelect 把网络事件和一个对象联系起来
WSAGetOverlappedResu 获得重叠操作的完成状态
WSAGetQOSByName 获得与指定的协议服务名字对应的QoS参数
WSAHtonl htonl()函数的扩展版本
WSAHtons htons()函数的扩展版本
WSAIoctl ioctl()函数的扩展版本,允许重叠操作
WSAJoinLeaf 在多点广播中加入一个叶节点
WSANtohl ntohl()函数的扩展版本
WSANtohs ntohs()函数的扩展版本
WSARecv recv()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSARecvDisconnect 终止套接字的接收操作,如果套接字是面向连接的,关闭连接
WSARecvFrom recvfrom()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSAResetEvent 重新初始化一个数据对象
WSASend send()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSASendDisconnect
WSASendTo sendto()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSASetEvent 设置一个数据对象
WSASocket socket()函数的扩展版本,它以一个PROTOCOL_INFO结构作为输入参数,允许创建重叠套接字和套接字组
WSAWaitForMultipleEvents 等待多个事件对象
gethostname(cha* **R *name,int namelen)
参数说明:
name: char数组
namelen:char数组大小
2.通过主机名查询主机信息
gethostbyname(const cha* **R*name)
WSAAsyncGetHostByName(HWND hWnd,unsigned int wMsg,const cha* **R*name,cha* **R*buf,int buflen)
对于IP地址字符串,函数不能返回正确的主机信息,应使用inet_addr()函数得到相应主机IP地址。
返回结构hostent定义如下
struct hostent{
cha* **R*h_name; //official name of host
cha* ******R*h_aliases; //alias list
short h_addrtype; //host address type
short h_length; //length of address
cha* ******R*h_addr_list; //list of addresses
#define h_addr h_addr_list[0] //address,for backward compat
}
参数说明:
hWnd 异步操作结束后收到消息的窗口句柄
wMsg 异步操作结束后的消息
buf 用于存放协议信息的缓冲区,其大小应大于sizeof(struct protoent),因为不同的WinSock实现,还可能有其他信息,所以建议缓冲区大小为MAXGETHOSTSTRUCT字节
buflen 指buf的字节数
name 与同步操作类似
3.通过地址查询主机信息的函数
gethostbyaddr(const cha* **R*addr,int len,int type)
WSAAsyncGetHostByAddr(HWND hWnd,unsigned int wMsg,const cha* **R*addr,int len,int type,cha* **R*buf,int buflen)
参数说明:
addr 为网络字节序的IP地址
len 指地址长度,对于PF_INET(TCP/IP协议族)必须等于4
type 地址类型,必须为PF_INET
hWnd与wMsg的含义同上
4.通过协议名查询协议信息
getprotobyname(const cha* **R*name)
WSAAsyncGetProtoByName(HWND hWnd,unsigned int wMsg,const FAR*name,cha* **R*buf,int buflen)
参数说明:
name 协议名称,如TCP、UDP等
struct protoent{
cha* **R*p_name; //协议的正式名称
cha* ******R*p_aliases; //以NULL结束的一串协议别名
short p_proto; //协议编号,主机字节序
};
hWnd与wMsg的含义同上
5.通过端口号查询协议信息
getprotobynumber(int number)
WSAAsyncGetProtoByNumber(HWND hWnd,unsigned int wMsg,int number,cha* **R*buf,int buflen)
参数说明:
number 为协议编号
6.通过服务名查询服务信息
getservbyname(const cha* **R*name,const cha* **R*proto)
WSAAsyncGetServByName(HWND hWnd,unsigned int wMsg,const cha* **R*name,const cha* **R*proto,cha* **R*buf,int buflen)
参数说明:
name 服务名称,如FTP、HTTP等
proto 协议名,如TCP、UDP等,也可以为NULL
struct servent{
cha* **R*s_name; //服务的正式名称
cha* ******R*s_aliases; //以NULL为结束标志的一串服务别名
short s_port; //与服务相关联的端口号,网络字节序
cha* **R*s_proto; //用户访问服务时使用的协议
}
7.通过端口查询的服务信息
getservbyport(int port,const cha* **R*proto)
WSAAsyncGetServByPort(HWND hWnd,unsigned int wMsg,int port,const cha* **R*proto,cha* **R*buf,int buflen);
参数说明:
port //端口号
proto //协议名,如TCP、UDP等,也可以为NULL
第二部分 辅助函数
1.字节序处理函数 网络字节顺序
u_short PASCAL htons(u_short hostshort)将16bit的主机字节顺序数据转换成网络字节顺序
u_long PASCAL htonl(u_long hostlong)将32bit的主机字节顺序数据转换成网络字节顺序
u_short PASCAL ntohs(u_short netshort)将16bit的网络字节顺序数据转换成主机字节顺序
u_long PASCAL ntohl(u_long netlong)将32bit的网络字节顺序数据转换成主机字节顺序
2.字节操作函数
#define bcopy(s,d,n) _fmemcpy((d),(s),(n))
#define bcmp(s1,s2,n) _fmemcmp((s1),(s2),(n))
#define bzero(s,n) _fmemset((s),0,(n))
3.地址转换函数
unsigned long PASCAL FAR inet_addr(const cha* **R*cp) //把由数字和小数点组成的字符串转变为32位IP地址(网络字节顺序)
cha* **R*PASCAL FAR inet_ntoa(struct in_addr in) //与上述相反
参数说明:
cp 为小数点分隔的十进制数字表示的IP地址,如202.113.244.6
in 是32bit网络字节顺序的IP地址
4.WinSock的初始化函数WSAStartup和结束函数WSACleanup
(1)int PASCAL FAR WSAStartup(WORD wVersionRequested,LPWSADATA lpWSAData)
参数说明:
wVersionRequested 指应用程序对WinSock版本的要求,它的低字节内容为主版本号,高字节为副版本号。当前为1.1
lpWSAData包含具体WinSock实现的一些信息,定义如下
typedef struct WSAData{ //成功返回零
WORD wVersion;
WORD wHighVersion;
char szDescription[WSADESCRIPTION_LEN+1];
char szSystemStatus[WSASYS_STATUS_LEN+1];
unsigned short iMaxSockets;
unsigned short iMaxUdpDg;
cha* **R*lpVendorInfo;
}WSADATA;
WSAStartup()函数必须在调用其他WinSock函数之前调用,否则,其他函数会返回错误。
典型用法为:
WORD wVersionRequested;
WSADATA wsaData;
int err;
wVersi(1,1);
err=WSAStartup(wVersionRequested,&wsaData);
if(err!=0)
{
//错误处理
return;
{
//如果当前系统的WinSock版本高于1.1,WSAStartup仍然返回1.1
if(LOBYTE(wsaData.wVersion)!=1||HIBYTE(wsaData.wVersion)!=1)
{
//不支持1.1版本
return;
}
(2)int PASCAL FAR WSACleanup(void)
第三部分 WinSock2.0
1.多点通信
WSASocket(
SOCKET s; //地址族
int type; //连接类型
int protocol; //协议类型
LPWSAPROTOCOL_INFO pinfo; //低层协议信息
GROUP g; //套接字组号
DWORD dwFlag; //标志,可以定义为叶节点或根节点
)
WSAJoinLeaf(
SOCKET s; //套接字
sockadd* **R*name; //地址
DWORD namelen; //地址长度
LPWSABUF lpCalleeDATA; //被调用者返回参数
LPWSABUF lpCalleeData; //调用者返回参数
LPQoS lpSQoS; //QoS参数
LPQoS lpGQoS; //QoS参数
DWORD dwFlags; //标志
)
2.WinSock2新增加的函数
函数 说明
WSAAccept accept()函数的扩展版本,支持条件接收和套接字组
WSACloseEvent 释放一个事件对象
WSAConnect connect()函数的扩展版本,支持连接数据交换和QoS规范
WSACreateEvent 创建一个事件对象
WSADuplicateSocket 为一个共享套接字创建一个新的套接字描述符
WSAEnumNetworkEvent 查询是否有网络事件发生
WSAEnumProtocols 获得所有协议的信息
WSAEventSelect 把网络事件和一个对象联系起来
WSAGetOverlappedResu 获得重叠操作的完成状态
WSAGetQOSByName 获得与指定的协议服务名字对应的QoS参数
WSAHtonl htonl()函数的扩展版本
WSAHtons htons()函数的扩展版本
WSAIoctl ioctl()函数的扩展版本,允许重叠操作
WSAJoinLeaf 在多点广播中加入一个叶节点
WSANtohl ntohl()函数的扩展版本
WSANtohs ntohs()函数的扩展版本
WSARecv recv()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSARecvDisconnect 终止套接字的接收操作,如果套接字是面向连接的,关闭连接
WSARecvFrom recvfrom()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSAResetEvent 重新初始化一个数据对象
WSASend send()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSASendDisconnect
WSASendTo sendto()函数的扩展版本,支持分散/聚集I/O和重叠套接字操作
WSASetEvent 设置一个数据对象
WSASocket socket()函数的扩展版本,它以一个PROTOCOL_INFO结构作为输入参数,允许创建重叠套接字和套接字组
WSAWaitForMultipleEvents 等待多个事件对象