Socket

1. WSAStartup 
在使用WinSock API之前，必须调用WSAStartup，调用成功返回0。 
int WSAStartup(WORD v, (LPWSADATA)& wd) 
WORD v: Socket版本，低字节为主版本号，高字节为副版本号。Eg. v1.1 = 0x0101; v2.0 = 0x0002。 (LPWSADATA)& wd: 指向WSADATA结构。 

WSADATA结构 
struct WSADATA 
{ 
WORD wVersion; DLL支持的WinSock规范的版本。 
WORD wHighVersion; DLL可支持的WinSock规范的最高版本。 
char szDescription[WSADESCRIPTION_LEN+1]; DLL的说明及厂商描述。 
char szSystemStatus[WSASYSTEMSTATUS_LEN+1]; DLL相关状态及配置信息。 
unsigned short iMaxSockets; 一个进程可打开的最大套借口数目。 
unsigned short iMaxUdpDg; 应用程序发送或接收的最大UDP数据报的大小。iMaxUdpDg为0表示最大8192，最小为512。 
char FAR* lpVendorInfo; 指向厂商规定数据结构的远指针 
}

2. WSACleanup
结束使用WinSock时调用，调用成功返回0。 
int WSACleanup()

3. socket 
Socket是一个通信的端口，返回-1表示失败，否则返回套接口的描述字 
SOCKET socket(int af, int type, int protocol) 
int af: 套接口所用地址族。AF_INET TCP/IP地址; AF_UNIX UNIX地址。 
int type: 套接口类型。SOCK_STREAM 数据流套接口，对应TCP协议;SOCK_DGRAM 数据流套接口，对应UDP协议。
int protocol: 套接口所用协议。IPPROC_TCP使用TCP/IP的TCP协议; IPPROC_UDP使用TCP/IP的UDP协议。

4. 主机地址标识的数据结构 
struct sockaddr 
{ 
u_short sa_family; //协议族 
char sa_data[14]; //主机地址标识(端口号，IP地址) 
} 

struct socketaddr_in 
{ 
short sin_family; //协议族 
u_short sin_port; //16bit端口号，网络字节顺序 
struct in_addr sin_addr;//32bit的IP地址，网络字节顺序 
char sin_zero[8] //未用 
} 

struct in_addr 
{ 
u_long s_addr; //32bit的IP地址，网络字节顺序 
} 

网络字节顺序：16bit/32bit整数存放格式——高字节在前，低字节在后

5. 设置主机地址 
void SetSockAddr(struct socketaddr_in* A, WORD Port, char* IP) 
{ 
A->sin_family = AF_INET; //TCP/IP协议 
A->sin_port = htons(Port); //端口号 
A->sin_addr.s_addr = inet_addr(IP) //IP地址 
} 

htons(): 把16bit的数字从主机字节顺序转换到网络字节顺序 
inet_addr(): 把一个IP地址格式"A.B.C.D"转换成32bit的网络字节顺序 
Intel CPU的主机字节顺序：16bit/32bit整数存放格式——低字节在前，高字节在后

6. Socket与主机地址绑定 
将IP地址和端口号与所创建的Socket号联系起来，返回值0表示调用成功 
int bind(SOCKET s, struct sockaddr far* name, int len) 
SOCKET s: //待捆绑
socket struct sockaddr far* name: //赋予socket的主机地址标识 
int len: //name的长度

7. sendto
向一指定目的地发送数据
int sendto(SOCKET s, char* buf, int buflen, int flags, struct sockaddr FAR* to, int tolen);
SOCKET s   源套接口
char* buf   待发送数据的缓冲区
int buflen   缓冲区中数据的长度
int flags   调用方式标志位,一般取0
struct sockaddr FAR* to   指向目的套接口的主机地址
int tolen 目的套接口主机地址的长度

8. recvfrom
从一个套接口接收数据
int recvfrom(SOCKET s, char* buf, int len, int flags, struct sockaddr FAR* from, int fromlen);
SOCKET s   接收套接口
char* buf   接收数据的缓冲区
int len   缓冲区中数据的长度
int flags   调用方式标志位,一般取0
struct sockaddr FAR* from   获取发送套接口的主机地址
int fromlen   发送套接口的主机地址的长度

9. send
向一个套接口发送数据
int send(SOCKET s, char* buf, int len, int flags);
SOCKET s   发送套接口
char* buf   发送数据的缓冲区
int len   缓冲区中数据的长度
int flags   调用方式标志位,一般取0 

10. recv
从一个套接口接收数据 
int recvfrom(SOCKET s, char* buf, int len, int flags);
SOCKET s   接收套接口
char* buf   接收数据的缓冲区
int len   缓冲区中数据的长度
int flags   调用方式标志位,一般取0

11. connect 
建立连接,返回0表示成功
int connect(SOCKET s, struct sockaddr FAR * name, int namelen);
SOCKET s   指定用于连接的套接字句柄
struct sockaddr FAR * name   指定要连接到的服务器的IP地址与端口
int namelen   sockaddr结构的长度

12. listen 
设置等待连接状态,返回0表示成功
int listen(SOCKET s, int backlog);
SOCKET s   被监听的端口
int backlog 

13. accept 
接受连接请求,返回值为SOCKET只负责通讯不负责连接
SOCKET accept(SOCKET s, struct sockaddr FAR * addr, int FAR * addrlen);
SOCKET s   监听的端口,只负者连接不负责通讯
struct sockaddr FAR * addr   远程连接的地址与端口
int FAR * addrlen 

14. select
监视我们需要监视的文件描述符的变化情况读写或是异常
int select(int nfds,fd_set* readfds,fd_set* writefds,fd_set* exceptfds,struct timeval* timeout);
int nfds   集合中所有文件描述符的范围，即所有文件描述符的最大值加1

fd_set* readfds   指向fd_set结构的指针，这个集合中应该包括文件描述符，我们是要监视这些文件描述符的读变化的，即我们关心是否可以从这些文件中读取数据了，如果这个集合中有一个文件可读，select就会返回一个大于0的值，表示有文件可读，如果没有可读的文件，则根据timeout参数再判断是否超时，若超出timeout的时间，select返回0，若发生错误返回负值。可以传入NULL值，表示不关心任何文件的读变化

fd_set* writefds   指向fd_set结构的指针，这个集合中应该包括文件描述符，我们是要监视这些文件描述符的写变化的，即我们关心是否可以向这些文件中写入数据了，如果这个集合中有一个文件可写，select就会返回一个大于0的值，表示有文件可写，如果没有可写的文件，则根据timeout参数再判断是否超时，若超出timeout的时间，select返回0，若发生错误返回负值。可以传入NULL值，表示不关心任何文件的写变化

fd_set* exceptfds   同上面两个参数的意图，用来监视文件错误异常
struct timeval* timeout   select的超时时间

15. closesocket
关闭socket
int closesocket(SOCKET s);