Windows Sockets为了支持Windows消息驱动机制,使应用程序开发者能够方便地处理网络通信,对网络事件采用了基于消息的异步存取策略;
1、WSAAsyncSelect
该函数为指定的套接字(socket)请求基于Windows消息的网络事件通知,并自动将该套接字设置为非阻塞模式;
int WSAAsyncSelect (
SOCKET s,
HWND hWnd,
unsigned int wMsg,
long lEvent
);
s:标识请求网络事件通知的套接字;
hWnd:标识一个网络事件发生时接收消息的窗口的句柄;
wMsg:指定网络事件发生时窗口将接收到的消息;
lEvent:指定应用程序感兴趣的网络事件,包括:
FD_READ --有关是否可读的通知,以便读取数据
FD_WRITE --有关是否可写的通知,以便发送数据
FD_OOB --是否带外(OOB)数据抵达的通知
FD_ACCEPT --与进入连接有关的通知
FD_CONNECT --连接操作已完成的通知
FD_CLOSE --与套接字关闭有关的通知
FD_QOS --套接字“服务质量”发生更改的通知
FD_GROUP_QOS --套接字组“服务质量”发生更改的通知
FD_ROUTING_INTERFACE_CHANGE --在指定的方向上,与路由接口发生变化有关的通知
FD_ADDRESS_LIST_CHANGE --针对套接字的协议家族,本地地址列表发生变化的通知
2、WSAEnumProtocols
该函数可获得系统中安装的网络协议的相关信息,该函数不能重复调用,传入的缓冲区必须足够大以便能存放所有元素;
int WSAEnumProtocols (
LPINT lpiProtocols,
LPWSAPROTOCOL_INFO lpProtocolBuffer,
ILPDWORD lpdwBufferLength
);
lpiProtocols:一个以NULL结尾的协议标识号数组;如果为NULL,则该函数返回所有可用协议的信息,否则只返回数组中列出的协议信息;
lpProtocolBuffer:作为返回值使用,一个用WSAPROTOCOL_INFO结构体填充的缓冲区;WSAPROTOCOL_INFO结构体用来存放或得到一个指定协议的完整信息;
lpdwBufferLength:在输入时,指定传递给该函数的参数lpProtocolBuffer缓冲区的长度;在输出时,存有获取所有请求信息需传递给该函数的最小缓冲区的长度;
3、WSAStartup
该函数将初始化进程使用的socket库;
int WSAStartup (
WORD wVersionRequested,
LPWSADATA lpWSAData
);
wVersionRequested:可以使用的socket库的版本;高位字节指定库的副版本,低位字节为主版本;
lpWSAData:返回可用库的信息,是一个指向WSADATA数据结构类型变量的指针;
4、WSACleanup
该函数将终止程序对socket库的使用;
int WSACleanup();
5、WSASocket
该函数将创建套接字;
SOCKET WSASocket (
int af,
int type,
int protocol,
LPWSAPROTOCOL_INFO lpProtocolInfo,
GROUP g,
DWORD dwFlags
);
af:指定地址族,AF_UNIX/AF_LOCAL/AF_FILE--本地通信;AF_INET--网络通信IPv4(主用);AF_INET6--网络通信IPv6(前缀AF替换成PF效果一样);
type:指定socket类型,SOCK_STREAM--流式套接字,SOCK_DGRAM--数据报式套接字;
protocol:推荐为0;
lpProtocolInfo:一个指向WSAPROTOCOL_INFO结构体的指针,该结构体定义了所创建的套接字的特性;可以为NULL;
g:保留参数;
dwFlags:指定套接字属性的描述;如果设为WSA_FLAG_OVERLAPPED,将创建一个重叠套接字;
6、WSARecv---recv函数的扩展版本
int WSARecv (
SOCKET s,
LPWSABUF lpBuffers,
DWORD dwBufferCount,
LPDWORD lpNumberOfBytesRecvd,
LPDWORD lpFlags,
LPWSAOVERLAPPED lpOverlapped,
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE
);
7、WSASend---send函数的扩展版本
int WSASend (
SOCKET s,
LPWSABUF lpBuffers,
DWORD dwBufferCount,
LPDWORD lpNumberOfBytesSent,
DWORD dwFlags,
LPWSAOVERLAPPED lpOverlapped,
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE
);
8、WSARecvFrom---recvfrom函数的扩展版本
该函数接收数据报类型的数据,并保存数据发送方的地址;通过该函数的第2个参数可知,在调用该函数接收数据时,可同时定义多个WSABUF结构体变量来接收数据,并通过该函数的第3个参数指定WSABUF结构体的数量;
int WSARecvFrom (
SOCKET s,
LPWSABUF lpBuffers,
DWORD dwBufferCount,
LPDWORD lpNumberOfBytesRecvd,
LPDWORD lpFlags,
struct sockaddr FAR * lpFrom,
LPINT lpFromlen,
LPWSAOVERLAPPED lpOverlapped,
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE
);
s:标识套接字;
lpBuffers:指向WSABUF结构体数组的指针,该结构体的定义为:
typedef struct __WSABUF{
u_long len; //缓冲区的长度
char FAR *buf; //指向缓冲区的指针
}WSABUF, FAR * LPWSABUF;
dwBufferCount:lpBuffers数组中WSABUF结构体的数目;
lpNumberOfBytesRecvd:指向本次调用所接收的字节数的指针;
lpFlags:取值包括:
MSG_PEEK --浏览到来的数据,这些数据被复制到缓冲区,但并不从输入队列中移除;仅对非重叠套接字有效;
MSG_OOB --处理带外(OOB)数据
MSG_PARTIAL --仅用于面向消息的套接字;作为输出参数时,表明数据是发送方传送的消息的一部分,消息的剩余部分将在随后的接收操作中被传送,如果随后的某个接收操作没有此标志,就表明这是发送方发送的消息的尾部;作为输入参数时,表明接收操作已完成,即使只是一条消息的部分数据已被服务提供者所接收;
lpFrom:一个可选的指针,指向重叠操作完成后存放源地址的缓冲区;
lpFromlen:一个指向lpFrom指定的缓冲区大小的指针,仅当指定了lpFrom参数时才须使用该参数;
lpOverlapped:一个指向WSAOVERLAPPED结构体的指针,非重叠套接字则忽略此参数;
lpCompletionROUTINE:一个指向接收操作完成时调用的完成例程的指针,该例程实际上就是如下所示的一个回调函数,非重叠套接字则忽略此参数;
void CALLBACK CompletionROUTINE(
IN DWORD dwError,
IN DWORD cbTransferred,
IN LPWSAOVERLAPPED lpOverlapped,
IN DWORD dwFlags
);
9、WSASendTo---sendto函数的扩展版本
int WSASendTo (
SOCKET s,
LPWSABUF lpBuffers,
DWORD dwBufferCount,
LPDWORD lpNumberOfBytesSent,
DWORD dwFlags,
const struct sockaddr FAR * lpTo,
int iToLen,
LPWSAOVERLAPPED lpOverlapped,
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE
);
s:标识一个套接字
lpBuffers:一个指向WSABUF结构体的指针;
dwBufferCount:lpBuffers数组中WSABUF结构体的数目;
lpNumberOfBytesSent:一个指向本次调用所发送的字节数的指针;
dwFlags:指示影响操作行为的标志位,设为0;
lpTo:可选指针,指向目标套接字的地址;
iToLen:lpTo中地址的长度;
lpOverlapped:一个指向WSAOVERLAPPED结构体的指针,非重叠套接字忽略该参数;
lpCompletionROUTINE:一个指向接收操作完成时调用的完成例程的指针,非重叠套接字忽略该参数;