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 。