关于socket()(转)-白红宇

关于socket()(转)

阅读量：4037 次

发布时间：2019-05-24

本文共 10629 字，大约阅读时间需要 35 分钟。

5.1.23 socket()

简述：

创建一个套接口。

#include <winsock.h>

SOCKET PASCAL FAR socket( int af, int type, int protocol)&#59;

af：一个地址描述。目前仅支持PF_INET格式，也就是说ARPA Internet地址格式。

type：新套接口的类型描述。

protocol：套接口所用的协议。如调用者不想指定，可用0。

注释：

socket()函数用于根据指定的地址族、数据类型和协议来分配一个套接口的描述字及其所用的资源。如果协议protocol未指定（等于0），则使用缺省的连接方式。

对于使用一给定地址族的某一特定套接口，只支持一种协议。但地址族可设为AF_UNSPEC（未指定），这样的话协议参数就要指定了。协议号特定于进行通讯的“通讯域”。支持下述类型描述：

类型解释

SOCK_STREAM 提供有序的、可靠的、双向的和基于连接的字节流，使用带外数据传送机制，为Internet地址族使用TCP。

SOCK_DGRAM 支持无连接的、不可靠的和使用固定大小（通常很小）缓冲区的数据报服务，为Internet地址族使用UDP。

SOCK_STREAM类型的套接口为全双向的字节流。对于流类套接口，在接收或发送数据前必需处于已连接状态。用connect()调用建立与另一套接口的连接，连接成功后，即可用send()和recv()传送数据。当会话结束后，调用closesocket()。带外数据根据规定用send()和 recv()来接收。

实现SOCK_STREAM类型套接口的通讯协议保证数据不会丢失也不会重复。如果终端协议有缓冲区空间，且数据不能在一定时间成功发送，则认为连接中断，其后续的调用也将以WSAETIMEOUT错误返回。

SOCK_DGRAM类型套接口允许使用sendto()和recvfrom()从任意端口发送或接收数据报。如果这样一个套接口用connect()与一个指定端口连接，则可用send()和recv()与该端口进行数据报的发送与接收。

返回值：

若无错误发生，socket()返回引用新套接口的描述字。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。

错误代码：

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

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

WSAEAFNOSUPPORT：不支持指定的地址族。

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

WSAEMFILE：无可用文件描述字。

WSAENOBUFS：无可用缓冲区，无法创建套接口。

WSAEPROTONOSUPPORT：不支持指定的协议。

WSAEPROTOTYPE：指定的协议不适用于本套接口。

WSAESOCKTNOSUPPORT：本地址族中不支持该类型套接口。

参见：

accept(), bind(), connect(), getsockname(), getsockopt(), setsockopt(), listen(), recv(), recvfrom(), select(), send(), sendto(), shutdown(), ioctlsocket().4.2 数据库例程

5.2 数据库函数

5.2.1 gethostbyaddr()

简述：

返回对应于给定地址的主机信息。

#include <winsock.h>

struct hostent FAR *PASCAL FAR gethostbyaddr(const char

FAR * addr, int len, int type)&#59;

addr：指向网络字节顺序地址的指针。

len：地址的长度，在PF_INET类型地址中为4。

type：地址类型，应为PF_INET。

注释：

gethostbyaddr()返回对应于给定地址的包含主机名字和地址信息的hostent结构指针。结构的声明如下：

struct hostent {

char FAR * h_name&#59;

char FAR * FAR * h_aliases&#59;

short h_addrtype&#59;

short h_length&#59;

char FAR * FAR * h_addr_list&#59;

}&#59;

结构的成员有：

成员用途

h_name 正规的主机名字（PC）。

h_aliases 一个以空指针结尾的可选主机名队列。

h_addrtype 返回地址的类型，对于Windows Sockets，这个域总是PF_INET。

h_legnth 每个地址的长度（字节数），对应于PF_INET这个域应该为4。

h_addr_list 应该以空指针结尾的主机地址的列表，返回的地址是以网络顺序排列的

为了保证其他旧的软件的兼容性，h_addr_list[0]被定义为宏h_addr。

返回的指针指向一个由Windows Sockets实现分配的结构。应用程序不应该试图修改这个结构或者释放它的任何部分。此外，每一线程仅有一份这个结构的拷贝，所以应用程序应该在发出其他Windows Scokets API调用前，把自己所需的信息拷贝下来。

返回值：

如果没有错误发生，gethostbyaddr()返回如上所述的一个指向hostent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSAHOST_NOT_FOUND 没有找到授权应答主机。

WSATRY_AGAIN 没有找到非授权主机，或者SERVERFAIL。

WSANO_RECOVERY 无法恢复的错误，FORMERR，REFUSED，NOTIMP。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetHostByAddr(), gethostbyname()

5.2.2 gethostbyname()

简述：

返回对应于给定主机名的主机信息。

#include <winsock.h>

struct hostent FAR *PASCAL FAR gethostbyname(const char

FAR * addr)&#59;

name：指向主机名的指针。

注释：

gethostbyname()返回对应于给定主机名的包含主机名字和地址信息的hostent结构指针。结构的声明与gethostaddr()中一致。

gethostbyname() 实现没有必要识别传送给它的IP地址串。对于这样的请求，应该把IP地址串当作一个未知主机名同样处理。如果应用程序有IP地址串需要处理，它应该使用 inet_addr()函数把地址串转换为IP地址，然后调用gethostbyaddr()来得到hostent结构。

返回值：

如果没有错误发生，gethostbyname()返回如上所述的一个指向hostent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSAHOST_NOT_FOUND 没有找到授权应答主机。

WSATRY_AGAIN 没有找到非授权主机，或者SERVERFAIL。

WSANO_RECOVERY 无法恢复的错误，FORMERR，REFUSED，NOTIMP。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetHostByName(), gethostbyaddr()

5.2.3 gethostname()

简述：

返回本地主机的标准主机名。

#include <winsock.h>

int PASCAL FAR gethostname(char FAR *name, int namelen)&#59;

name：一个指向将要存放主机名的缓冲区指针。

namelen：缓冲区的长度。

注释：

该函数把本地主机名存放入由name参数指定的缓冲区中。返回的主机名是一个以NULL结束的字符串。主机名的形式取决于Windows Sockets实现－它可能是一个简单的主机名，或者是一个域名。然而，返回的名字必定可以在gethostbyname()和 WSAAsyncGetHostByName()中使用。

返回值：

如果没有错误发生，gethostname()返回0。否则它返回SOCKET_ERROR。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSAEFAULT 名字长度参数太小。

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

参见：gethostbyname(), WSAAsyncGetHostByName()

5.2.4 getprotobyname()

简述：

返回对应于给定协议名的相关协议信息。

#include <winsock.h>

struct protoent FAR * PASCAL FAR getprotobyname(const char

FAR * name)&#59;

name：一个指向协议名的指针。

注释：

getprotobyname()返回对应于给定协议名的包含名字和协议号的protoent结构指针。结构的声明如下：

struct protoent {

char FAR * p_name&#59;

char Far * far * p_aliases&#59;

short p_proto&#59;

}&#59;

结构的成员有：

成员用途

p_name 正规的协议名。

p_aliases 一个以空指针结尾的可选协议名队列。

p_proto 以主机字节顺序排列的协议号

返回值：

如果没有错误发生，getprotobyname()返回如上所述的一个指向protoent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSANO_RECOVERY 无法恢复的错误，FORMERR，REFUSED，NOTIMP。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetProtoByName(), getprotobynumber()

5.2.5 getprotobynumber()

简述：

返回对应于给定协议号的相关协议信息。

#include <winsock.h>

struct protoent FAR * PASCAL FAR getprotobynumber(int number)&#59;

number：一个以主机顺序排列的协议号。

注释：

getprotobynumber()返回对应于给定协议名的包含名字和协议号的protoent结构指针。结构的声明与getprotobyname中的一致。

返回值：

如果没有错误发生，getprotobynumber()返回如上所述的一个指向protoent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSANO_RECOVERY 无法恢复的错误，FORMERR，REFUSED，NOTIMP。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetProtoByNumber(), getprotobyname()

5.2.6 getservbyname()

简述：

返回对应于给定服务名和协议名的相关服务信息。

#include <windows.h>

struct servent FAR * PASCAL FAR getservbyname(const char

Far * name, const char FAR *proto)&#59;

name：一个指向服务名的指针。

proto：指向协议名的指针（可选）。如果这个指针为空，getservbyname()返回第一个name与s_name或者某一个s_aliases匹配的服务条目。否则getservbyname()对name和proto都进行匹配。

注释：

getservbyname()返回与给定服务名对应的包含名字和服务号信息的servent结构指针。结构的声明如下：

struct servent {

char FAR * s_name&#59;

char Far * FAR * s_aliases&#59;

short s_port&#59;

char FAR * s_proto&#59;

}&#59;

结构的成员有：

成员用途

s_name 正规的服务名。

s_aliases 一个以空指针结尾的可选服务名队列。

s_port 连接该服务时需要用到的端口号，返回的端口号是以网络字节顺序排列的。

s_proto 连接该服务时用到的协议名。

返回值：

如果没有错误发生，getservbyname()返回如上所述的一个指向servent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSAHOST_NOT_FOUND 没有找到授权应答主机。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetServByName(), getservbyport()

5.2.7 getservbyport()

简述：

返回对应于给定端口号和协议名的相关服务信息。

#include <windows.h>

struct servent FAR * PASCAL FAR getservbyport(int port,

const char FAR *proto)&#59;

port：给定的端口号，以网络字节顺序排列。

proto：指向协议名的指针（可选）。如果这个指针为空，getservbyport()返回第一个port与s_port匹配的服务条目。否则getservbyport()对port和proto都进行匹配。

注释：

getservbyport()返回与给定服务名对应的包含名字和服务号信息的servent结构指针。结构的声明与getservbyname()中一致。

返回值：

如果没有错误发生，getservbyport()返回如上所述的一个指向servent结构的指针，否则，返回一个空指针。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

WSAHOST_NOT_FOUND 没有找到授权应答主机。

WSANO_DATA 有效的名字，但没有关于请求类型的数据记录。

WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

WSAEINTR 阻塞调用被WSACancelBlockingCall()取消了.

参见: WSAAsyncGetServByPort(), getservbyname()

5.3 Windows扩展函数

5.3.1 WSAAsyncGetHostByAddr()

简述:

获得对应于一个地址的主机信息.－异步版本.

#include <winsock.h>

HANDLE PASCAL FAR WSAAsyncGetHostByAddr ( HWND hWnd,

unsigned int wMsg, const char FAR * addr, int len, int

type, char FAR * buf, int buflen )&#59;

hWnd 当异步请求完成时,应该接收消息的窗口句柄.

wMsg 当异步请求完成时,将要接收的消息.

addr 主机网络地址的指针.主机地址以网络字节次序存储.

len 地址长度.对于PF_INET来说必须为4.

type 地址类型,必须是PF_INET.

buf 接收hostent数据的数据区指针.注意该数据区必须大于hostent结构的大小.这是因为不仅Windows Sockets实现要用该数据区域容纳hostent结构,hostent结构的成员引用的所有数据也要在该区域内.建议用户提供一个 MAXGETHOSTSTRUCT字节大小的缓冲区.

buflen 上述数据区的大小.

注释:

本函数是gethostbyaddr()的异步版本,是用来获取对应于一个网络地址的主机名和地址信息.Windows Sockets的实现启动该操作后立刻返回调用方,并传回一个异步任务句柄,应用程序可以用它来标识该操作.当操作完成时,结果(若有的话)将会拷贝到调用方提供的缓冲区,同时向应用程序的窗口发一条消息.

当异步操作完成时,应用程序的窗口hWnd接收到消息wMsg. wParam参数包含了初次函数调用时返回的异步任务句柄.lParam的高16位包含着错误代码.该代码可以是winsock.h中定义的任何错误.错误代码为0说明异步操作成功.在成功完成的情况下,提供给初始函数调用的缓冲区中包含了一个hostent结构.为存取该结构中的元素,初始的缓冲区指针应置为hostent结构的指针,并一如平常地存取.

注意若错误代码为WSAENOBUFS,它说明在初始调用时由buflen指出的缓冲区大小对于容纳所有的结果信息来说太小了.在这种情况下,lParam的低16位含有提供所有信息所需的缓冲区大小数值.如果应用程序认为获取的数据不够,它就可以在设置了足够容纳所需信息的缓冲区后,重新调用WSAAsyncGetHostByAddr().(也就是大于lParam低16位提供的大小.)

错误代码和缓冲区大小应使用WSAGETASYNCERROR和WSAGETASYNCBUFLEN宏从lParam中取出.两个宏定义如下:

#define WSAGETASYNCERROR(lParam) HIWORD(lParam)

#define WSAGETASYNCBUFLEN(lParam) LOWORD(lParam)

使用这些宏可最大地提高应用程序源代码的可移植性.

返回值:

返回值指出异步操作是否成功地初启.注意它并不隐含操作本身的成功或失败.

若操作成功地初启,WSAAsyncGetHostByAddr()返回一个HANDLE类型的非0值, 作为请求需要的异步任务句柄.该值可在两种方式下使用.它可通过WSACancelAsyncRequest()用来取消该操作.也可通过检查 wParam消息参数,以匹配异步操作和完成消息.

如果异步操作不能初启,WSAAsyncGetHostByAddr()返回一个0值,并且可使用WSAGetLastError()来获取错误号.

WINDOWS SOCKETS 规范及应用

评价:

Windows Sockets的实现使用提供给该函数的缓冲区来构造hostent结构以及该结构成员引用的数据区内容.为避免上述的WSAENOBUFS错误,应用程序应提供一个至少MAXGETHOSTSTRUCT字节大小的缓冲区.

关于Windows Sockets提供者的说明：