SOCKET编程

WSAStartup函数

初始化Winsock

[声明]

int WSAStarup(WORD wVersionRequested,LPWSADATA lpWSAData);

[参数]

wVersionRequested - 要求使用Winsock的最低版本号

lpWSAData - Winsock的详细资料

[返回值]

当函数成功调用时返回0

失败时返回非0的值

---

socket函数

用于生成socket(soket Descriptor)

[声明]

SOCKET socket（int af,int type,int protocol）;

[参数]

af - 地址家族(通常使用:AF_INET)

type - socket的种类

SOCK_STREAM : 用于TCP协议

SOCK_DGRAM : 用于UDP协议

protocol - 所使用的协议

[返回值]

当函数成功调用时返回一个新的SOCKET(Socket Descriptor)

失败时返回INVALID_SOCKET.

---

inet_addr函数

地址转换, 把"A.B.C.D"的IP地址转换为32位长整数

[声明]

unsigned long inet_addr ( const char FAR *cp );

[参数]

cp - 指向IP地址字符串的指针

[返回值]

当函数成功调用时返回用32位整数表示的IP地址

失败时返回INADDR_NONE.

---

gethostbyname函数

从主机名获取主机信息.

[声明]

struct hostent FAR * gethostbyname ( const char FAR *name );

[参数]

name - 指向主机名字符串的指针

[返回值]

当函数成功调用时返回主机信息

失败时返回NULL(空值)

---

recv函数

利用Socket进行接受数据.

[声明]

int recv ( SOCKET s , char FAR *buf , int len , int flags );

[参数]

s - 指向用Socket函数生成的Socket Descriptor

buf - 接受数据的缓冲区(数组)的指针

len - 缓冲区的大小

flag - 调用方式(MSG_PEEK 或 MSG_OOB)

[返回值]

成功时返回收到的字节数.

如果连接被中断则返回0

失败时返回 SOCKET_ERROR

sendto函数

发送数据.

[声明]

int sendto ( SOCKET s , const char FAR *buf , int len , int flags , const struct sockaddr FAR *to , int token );

[参数]

s - 指向用Socket函数生成的Socket Descriptor

buf - 接受数据的缓冲区(数组)的指针

len - 缓冲区的大小

flag - 调用方式(MSG_DONTROUTE , MSG_OOB)

to - 指向发送方SOCKET地址的指针

token - 发送方SOCKET地址的大小

[返回值]

成功时返回已经发送的字节数.

失败时返回SOCKET_ERROR

closesocket函数

int closesocket(

      SOCKET s

    );

    closesocket函数用来关闭一个描述符为s套接字。由于每个进程中都有一个套接字描述符表，表中的每个套接字描述符都对应了一个位于操作系统缓冲区中的套接字数据结构，因此有可能有几个套接字描述符指向同一个套接字数据结构。套接字数据结构中专门有一个字段存放该结构的被引用次数，即有多少个套接字描述符指向该结构。当调用closesocket函数时，操作系统先检查套接字数据结构中的该字段的值，如果为1，就表明只有一个套接字描述符指向它，因此操作系统就先把s在套接字描述符表中对应的那条表项清除，并且释放s对应的套接字数据结构；如果该字段大于1，那么操作系统仅仅清除s在套接字描述符表中的对应表项，并且把s对应的套接字数据结构的引用次数减1。

closesocket函数如果执行成功就返回0，否则返回SOCKET_ERROR。

bind函数

int bind(

      SOCKET s,                          

      const struct sockaddr FAR *name,   

      int namelen                        

    );

   当创建了一个Socket以后，套接字数据结构中有一个默认的IP地址和默认的端口号。一个服务程序必须调用bind函数来给其绑定一个IP地址和一个特定的端口号。客户程序一般不必调用bind函数来为其Socket绑定IP地址和断口号。该函数的第一个参数指定待绑定的Socket描述符；第二个参数指定一个sockaddr结构，该结构是这样定义的：

struct sockaddr {

            u_short sa_family;

            char sa_data[14];

        };

sa_family指定地址族，对于TCP/IP协议族的套接字，给其置AF_INET。当对TCP/IP协议族的套接字进行绑定时，我们通常使用另一个地址结构：

        struct sockaddr_in {

            short    sin_family;

            u_short sin_port;

            struct in_addr sin_addr;

            char     sin_zero[8];

        };

   其中sin_family置AF_INET；sin_port指明端口号；sin_addr结构体中只有一个唯一的字段s_addr，表示IP地址，该字段是一个整数，一般用函数inet_addr（）把字符串形式的IP地址转换成unsigned long型的整数值后再置给s_addr。有的服务器是多宿主机，至少有两个网卡，那么运行在这样的服务器上的服务程序在为其Socket绑定IP地址时可以把htonl(INADDR_ANY)置给s_addr，这样做的好处是不论哪个网段上的客户程序都能与该服务程序通信；如果只给运行在多宿主机上的服务程序的Socket绑定一个固定的IP地址，那么就只有与该IP地址处于同一个网段上的客户程序才能与该服务程序通信。我们用0来填充sin_zero数组，目的是让sockaddr_in结构的大小与sockaddr结构的大小一致。

listen函数

    int listen( SOCKET s, int backlog );

   服务程序可以调用listen函数使其流套接字s处于监听状态。处于监听状态的流套接字s将维护一个客户连接请求队列，该队列最多容纳backlog个客户连接请求。假如该函数执行成功，则返回0；如果执行失败，则返回SOCKET_ERROR。

accept函数

    SOCKET accept(

      SOCKET s,

      struct sockaddr FAR *addr,

      int FAR *addrlen

    );

   服务程序调用accept函数从处于监听状态的流套接字s的客户连接请求队列中取出排在最前的一个客户请求，并且创建一个新的套接字来与客户套接字创建连接通道，如果连接成功，就返回新创建的套接字的描述符，以后与客户套接字交换数据的是新创建的套接字；如果失败就返回INVALID_SOCKET。该函数的第一个参数指定处于监听状态的流套接字；操作系统利用第二个参数来返回新创建的套接字的地址结构；操作系统利用第三个参数来返回新创建的套接字的地址结构的长度。

connect函数

    int connect(

      SOCKET s,                          

      const struct sockaddr FAR *name,

      int namelen                        

    );

   客户程序调用connect函数来使客户Socket s与监听于name所指定的计算机的特定端口上的服务Socket进行连接。如果连接成功，connect返回0；如果失败则返回SOCKET_ERROR。