Windows Sockets 编程常用函数

本文主要是介绍Windows Sockets 编程常用函数，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

inet_addr()函数

基本介绍：

功能：将一个点分十进制的IP转换成一个长整数型数（u_long类型）

原型： in_addr _t inet_addr(const char *cp); 　

参数：字符串，一个点分十进制的IP地址

返回值：如果正确执行将返回一个无符号长整数型数。如果传入的字符串不是一个合法的IP地址，将返回INADDR_NONE。

头文件：Winsock2.h.

arpa/inet.h（Linux)

基本注释：

本函数解释cp参数中的字符串，这个字符串用Internet的“.”间隔格式表示一个数字的Internet地址。返回值可用作Internet地址。所有Internet地址以网络字节顺序返回(字节从左到右排列)。

Internet地址用“.”间隔的地址可有下列几种表达方式：

a.b.c.d，a.b.c，a.b，a

当四个部分都有定值时，每个都解释成一个字节数据，从左到右组成Internet四字节地址。请注意，当一个Internet地址在Intel机器上表示成一个32位整型数时，则上述的字节为“d.c.b.a”。这是因为Intel处理器的字节是从右向左排列的。

请注意：只有Berkeley支持下述表达法，Internet其余各处均不支持。考虑到与软件的兼容性，应按规定进行使用。

对一个三部分地址，最后一部分解释成16位数据并作为网络地址的最右两个字节。这样，三部分地址便很容易表示B组网络地址，如“128.net.host”.

对一个两部分地址，最后一部分解释成24位数据并作为网络地址的最右三个字节，这样，两部分地址便很容易表示C组网络地址，如“net.host”。

对仅有一个部分的地址，则将它的值直接存入网络地址不作任何字节的重组。

返回值：

若无错误发生，inet_addr()返回一个无符号长整型数，其中以适当字节顺序存放Internet地址。如果传入的字符串不是一个合法的Internet地址，如“a.b.c.d”地址中任一项超过255，那么inet_addr()返回INADDR_NONE。在IP只有一部分时（即没有 ”.“ 时），IP的字符串如果只由数字组成，inet_addr()不检查数字是否大于255。

编程举例：

#include <Winsock2.h>

#include <stdio.h>

int main()

{

in_addr ipAddr;

ipAddr.S_un.S_addr = inet_addr("127.0.0.1"); //将字符串形式的IP地址转换为按网络字节顺序的整形值

printf("\n%u", ipAddr.S_un);

return 0;

}

listen()函数

listen在套接字函数中表示让一个套接字处于监听到来的连接请求的状态

头文件：

#include <sys/types.h>

#include <sys/socket.h>

函数声明: int listen(int sockfd, int backlog);

功能：listen函数使用主动连接套接口变为被连接套接口，使得一个进程可以接受其它进程的请求，从而成为一个服务器进程。在TCP服务器编程中listen函数把进程变为一个服务器，并指定相应的套接字变为被动连接。

listen函数在一般在调用bind之后-调用accept之前调用。

参数：

sockfd 一个已绑定未被连接的套接字描述符

backlog 连接请求队列 (queue of pending connections)

的最大长度（一般由2到4）。用SOMAXCONN则由

系统确定。

返回值：

无错误，返回0，

否则，返回SOCKET ERROR，可以调用函数WSAGetLastError取得错误代码。

说明：

(1) 执行listen 之后套接字进入被动模式。

(2) 队列满了以后，将拒绝新的连接请求。客户端将出现连接D 错误WSAECONNREFUSED。

(3) 在正在listen的套接字上执行listen不起作用。

例子：

if (listen( ListenSocket, 3) == SOCKET_ERROR)

printf("Error listening on socket.\n");

accept()函数

在一个套接口接受一个连接。accept() 是c语言中网络编程的重要的函数，和windows 编程也有所不同，其不是在winsock.h头文件中，而是在#include <sys/socket.h>中。

文件包含

#include <sys/socket.h>

原型

SOCKET PASCAL FAR accept( SOCKET s, struct sockaddr FAR* addr,int FAR* addrlen);

参数

s：套接口描述字，该套接口在 listen() 后监听连接。

addr：（可选）指针，指向一缓冲区，其中接收为通讯层所知的连接实体的地址。Addr参数的实际格式由套接口创建时所产生的地址族确定。

addrlen：（可选）指针，输入参数，配合addr一起使用，指向存有addr地址长度的整型数。

返回值

成功返回一个新的套接字描述符，失败返回-1。

本函数从s的等待连接队列中抽取第一个连接，创建一个与s同类的新的套接口并返回句柄。如果队列中无等待连接，且套接口为阻塞方式，则accept()阻塞调用进程直至新的连接出现。如果套接口为非阻塞方式且队列中无等待连接，则accept()返回一错误代码。已接受连接的套接口不能用于接受新的连接，原套接口仍保持开放。

addr参数为一个返回参数，其中填写的是为通讯层所知的连接实体地址。addr参数的实际格式由通讯时产生的地址族确定。addrlen参数也是一个返回参数，在调用时初始化为addr所指的地址空间；在调用结束时它包含了实际返回的地址的长度（用字节数表示）。该函数与SOCK_STREAM类型的面向连接的套接口一起使用。如果addr与addrlen中有一个为零NULL，将不返回所接受的套接口远程地址的任何信息。

返回值：

如果没有错误产生，则accept()返回一个描述所接受包的SOCKET类型的值。否则的话，返回INVALID_SOCKET错误，应用程序可通过调用WSAGetLastError()来获得特定的错误代码。

错误代码：

addrlen所指的整形数初始时包含addr所指地址空间的大小，在返回时它包含实际返回地址的字节长度。

WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。

WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。

WSAEFAULT：addrlen参数太小（小于socket结构的大小）。

WSAEINTR：通过一个 WSACancelBlockingCall() 来取消一个（阻塞的）调用。

WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。

WSAEINVAL：在accept()前未激活listen()。

WSAEMFILE：调用accept()时队列为空，无可用的描述字。

WSAENOBUFS：无可用缓冲区空间。

WSAENOTSOCK：描述字不是一个套接口。

WSAEOPNOTSUPP：该套接口类型不支持面向连接服务。

WSAEWOULDBLOCK：该套接口为非阻塞方式且无连接可供接受。

WSAECONNRESET：接受连接后在accept返回之前，被远程客户端断开连接。

参见：

bind(), connect() , listen(), select() , socket() , WSAAsyncSelect() .

send() 函数

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

不论是客户还是服务器应用程序都用send函数来向TCP连接的另一端发送数据。客户程序一般用send函数向服务器发送请求，而服务器则通常用send函数来向客户程序发送应答。

该函数的第一个参数指定发送端套接字描述符；

第二个参数指明一个存放应用程序要发送数据的缓冲区；

第三个参数指明实际要发送的数据的字节数；

第四个参数一般置0。

这里只描述同步Socket的send函数的执行流程。当调用该函数时，

（1）send先比较待发送数据的长度len和套接字s的发送缓冲的长度，如果len大于s的发送缓冲区的长度，该函数返回SOCKET_ERROR；

（2）如果len小于或者等于s的发送缓冲区的长度，那么send先检查协议是否正在发送s的发送缓冲中的数据，如果是就等待协议把数据发送完，如果协议还没有开始发送s的发送缓冲中的数据或者s的发送缓冲中没有数据，那么send就比较s的发送缓冲区的剩余空间和len

（3）如果len大于剩余空间大小，send就一直等待协议把s的发送缓冲中的数据发送完

（4）如果len小于剩余空间大小，send就仅仅把buf中的数据copy到剩余空间里（注意并不是send把s的发送缓冲中的数据传到连接的另一端的，而是协议传的，send仅仅是把buf中的数据copy到s的发送缓冲区的剩余空间里）。

如果send函数copy数据成功，就返回实际copy的字节数，如果send在copy数据时出现错误，那么send就返回SOCKET_ERROR；如果send在等待协议传送数据时网络断开的话，那么send函数也返回SOCKET_ERROR。

要注意send函数把buf中的数据成功copy到s的发送缓冲的剩余空间里后它就返回了，但是此时这些数据并不一定马上被传到连接的另一端。如果协议在后续的传送过程中出现网络错误的话，那么下一个Socket函数就会返回SOCKET_ERROR。（每一个除send外的Socket函数在执行的最开始总要先等待套接字的发送缓冲中的数据被协议传送完毕才能继续，如果在等待时出现网络错误，那么该Socket函数就返回 SOCKET_ERROR）

注意：在Unix系统下，如果send在等待协议传送数据时网络断开的话，调用send的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

通过测试发现，异步socket的send函数在网络刚刚断开时还能发送返回相应的字节数，同时使用select检测也是可写的，但是过几秒钟之后，再send就会出错了，返回-1。select也不能检测出可写了。

recv()函数

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

不论是客户还是服务器应用程序都用recv函数从TCP连接的另一端接收数据。该函数的第一个参数指定接收端套接字描述符；

第二个参数指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据；

第三个参数指明buf的长度；

第四个参数一般置0。

这里只描述同步Socket的recv函数的执行流程。当应用程序调用recv函数时，

（1）recv先等待s的发送缓冲中的数据被协议传送完毕，如果协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR，

（2）如果s的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收缓冲区，如果s接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，直到协议把数据接收完毕。当协议把数据接收完毕，recv函数就把s的接收缓冲中的数据copy到buf中（注意协议接收到的数据可能大于buf的长度，所以在这种情况下要调用几次recv函数才能把s的接收缓冲中的数据copy完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的），

recv函数返回其实际copy的字节数。如果recv在copy时出错，那么它返回SOCKET_ERROR；如果recv函数在等待协议接收数据时网络中断了，那么它返回0。

注意：在Unix系统下，如果recv函数在等待协议接收数据时网络断开了，那么调用recv的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

这篇关于Windows Sockets 编程常用函数的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！