socket()

简述：

创建一个套接口。

#include <winsock.h>

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

af：一个地址描述。目前仅支持AF_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()返回引用新套接口的描述字。否则的话，返回INVAID_SOCKET错误，应用程序可通过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 数据库例程