winsock之基础函数

最新推荐文章于 2024-03-04 16:57:16 发布

jxhgh

最新推荐文章于 2024-03-04 16:57:16 发布

阅读量1k

点赞数

分类专栏：网络文章标签： socket pascal sockets struct windows internet

网络专栏收录该内容

6 篇文章 0 订阅

订阅专栏

WinSock API
　　Socket接口是网络编程（通常是TCP/IP协议，也可以是其他协议）的API。最早的Socket接口是Berkeley接口，在Unix操作系统中实现。WinSock也是一个基于Socket模型的API，在Microsoft Windows操作系统类中

使用。它在Berkeley接口函数的基础之上，还增加了基于消息驱动机制的Windows扩展函数。Winscok1.1只支持TCP/IP网络，WinSock2.0增加了对更多协议的支持。这里，讨论TCP/IP网络上的API。
编辑本段接口包括三类函数
　　第一类是WinSock API包含的Berkeley socket函数。这类函数分两部分。第一部分是用于网络I/O的函数，如 accept、closesocket、connect、recv、recvfrom、select、send、sendto 另一部分是不涉及

网络I/O、在本地端完成的函数，如　　bind、getpeername、getsockname、getsocketopt、htonl、htons、inet_addr、inet_nton 　　ioctlsocket、listen、ntohl、ntohs、setsocketopt、shutdow、socket等　

　第二类是检索有关域名、通信服务和协议等Internet信息的数据库函数，如gethostbyaddr、gethostbyname、gethostname、getprotolbyname 　　getprotolbynumber、getserverbyname、getservbyport。　

　第三类是Berkekley socket例程的Windows专用的扩展函数，如gethostbyname对应的WSAAsynGetHostByName（其他数据库函数除了gethostname都有异步版本），select对应的WSAAsynSelect，判断是否阻塞的函数

WSAIsBlocking，得到上一次Windsock API错误信息的WSAGetLastError，等等。
编辑本段阻塞函数和非阻塞函数从另外一个角度，这些函数又可以分为两类，一是阻塞函数，一是非阻塞函数。所谓阻塞函数，是指其完成指定的任务之前不允许程序调用另一个函数，在Windows下还会阻塞本线程消息的发送。所谓非阻塞函数，是指操作启动之后，如果可以立即得到结果就返回结果，否则返回表示结果需要等待的错误信息，不等待任务完成函数就返回。　　首先，异步函数是非阻塞函数；　　其次，获取远地信息的数据库函数是阻塞函数（因此，WinSock提供了其异步版本）；在Berkeley socket函数部分中，不涉及网络I/O、本地端工作的函数是非阻塞函数；　　在Berkeley socket函数部分中，网络I/O的函数是可阻塞函数，也就是它们可以阻塞执行，也可以不阻塞执行。这些函数都使用了一个socket，如果它们使用的socket是阻塞的，则这些函数是阻塞函数；如果它们使用的socket是非阻塞的，则这些函数是非阻塞函数。
编辑本段参数设定创建一个socket时，可以指定它是否阻塞。在缺省情况下，Berkerley的Socket函数和WinSock都创建“阻塞”的socket。阻塞socket通过使用select函数或者WSAAsynSelect函数在指定操作下变成非阻塞的。WSAAsyncSelect函数原型如下。 int WSAAsyncSelect( SOCKET s, HWND hWnd, u_int wMsg, long lEvent ); 其中，参数1指定了要操作的socket句柄；参数2指定了一个窗口句柄；参数3指定了一个消息，参数4指定了网络事件，可以是多个事件的组合，如：FD_READ 准备读 FD_WRITE 准备写 FD_OOB 带外数据到达 FD_ACCEPT 收到连接　　FD_CONNECT 完成连接FD_CLOSE 关闭socket。用OR操作组合这些事件值，如FD_READ|FD_WRITE WSAAsyncSelect函数表示对socket s监测lEvent指定的网络事件，如果有事件发生，则给窗口hWnd发送消息wMsg。　　假定应用程序的一个sockets指定了监测FD_READ事件，则在FD_READ事件上变成非阻塞的。当read函数被调用时，不管是否读到数据都马上返回，如果返回一个错误信息表示还在等待，则在等待的数据到达后，消息wMsg发送给窗口hWnd，应用程序处理该消息读取网络数据。　　对于异步函数的调用，以类似的过程最终得到结果数据。以gethostbyname的异步版本的使用为例进行说明。该函数原型如下：HANDLE WSAAsyncGetHostByName( HWND hWnd,u_int wMsg, const char FAR *name, char FAR *buf, int buflen ); 在调用WSAAsyncGetHostByName启动操作时，不仅指定主机名字name，还指定了一个窗口句柄hWnd，一个消息ID wMsg，一个缓冲区及其长度。如果不能立即得到主机地址，则返回一个错误信息表示还在等待。当要的数据到达时，WinSock DLL给窗口hWnd发送消息wMsg告知得到了主机地址，窗口过程从指定的缓冲区buf得到主机地址。使用异步函数或者非阻塞的socket，主要是为了不阻塞本线程的执行。在多进程或者多线程的情况下，可以使用两个线程通过同步手段来完成异步函数或者非阻塞函数的功能。

WSAStartup()
连结应用程序与Winsock.DLL 的第一个函数。
格式：
int WSAStartup( WORD wVersionRequested,LPWSADATA lpWSAData )
参数：
wVersionRequested 欲使用的 Windows Sockets API 版本
lpWSAData 指向 WSADATA 资料的指标
传回值：
成功 - 0
失败 - WSASYSNOTREADY / WSAVERNOTSUPPORTED / WSAEINVAL
说明：
此函数「必须」是应用程序呼叫到 Windows Sockets DLL 函数中的第一
个函数呼叫成功后，才可以再呼叫其他 Windows Sockets DLL 的函数。此函数亦让使用者可以指定要使用的 Windows Sockets API 版本，
及获取设计者的一些信息。

socket()
建立Socket。
格式：
SOCKET socket( int af, int type, int protocol )
参数：
af 目前只提供 PF_INET(AF_INET)
type Socket 的型态 (SOCK_STREAM、SOCK_DGRAM)
protocol 通讯协定(如果使用者不指定则设为0)
传回值：
成功 - Socket 的识别码
失败 - INVALID_SOCKET(呼叫 WSAGetLastError() 可得知原因)
说明：
此函数用来建立一 Socket，并为此 Socket 建立其所使用的资源。
Socket 的型态可为 Stream Socket 或 Datagram Socket。

bind()
指定 Socket 的 Local 地址 (Address)。
格式：
int bind( SOCKET s, const struct sockaddr FAR *name,int namelen );
参数：
s Socket的识别码
name Socket的地址值
namelen name的长度
传回值：
成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：
此一函数是指定 Local 地址及 Port 给某一未定名之 Socket。使用者若不
在意地址或 Port 的值，那麽他可以设定地址为 INADDR_ANY，及 Port 为 0；那么Windows Sockets 会自动将其设定适当之地址及 Port (1024 到 5000之间的值)，使用者可以在此 Socket 真正连接完成后，呼叫

getsockname() 来获知其被设定的值。
bind() 函数要指定地址及 port，这个地址必须是执行这个程序所在机器的 IP
地址，所以如果读者在设计程序时可以将地址设定为 INADDR_ANY，这样
Winsock 系统会自动将机器正确的地址填入。如果您要让程序只能在某台机器上
执行的话，那么就将地址设定为该台机器的 IP 地址。由於此端是 Server 端，所
以版主们一定要指定一个 port 号码给这个 socket。

listen()
设定 Socket 为监听状态，准备被连接。
格式：
int listen( SOCKET s, int backlog );
参数：
s Socket 的识别码
backlog 未真正完成连接前(尚未呼叫 accept 前)彼端的连接要求的最大个数
传回值：
成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：
使用者可利用此函数来设定 Socket 进入监听状态，并设定最多可有多少
个在未真正完成连接前的彼端的连接要求。(目前最大值限制为 5, 最小值为1)

connect()
要求连接某一 TCP Socket 到指定的对方。
格式：
int connect( SOCKET s, const struct sockaddr FAR *name, int namelen );
参数：
s Socket 的识别码
name 此 Socket 想要连接的对方地址
namelen name的长度
传回值：
成功 - 0
失败 - SOCKET_ERROR (呼叫WSAGetLastError()可得知原因)
说明：
此函数用来向对方要求建立连接。若是指定的对方地址为 0 的话，会传
回错误值。当连接建立完成后，使用者即可利用此一 Socket 来做传送或接收资料之用了。

accept()
接受某一 Socket 的连接要求，以完成 Stream Socket 的连接。
格式：
SOCKET accept(SCOKET s, SOCKADDR *addr,int FAR *addrlen )
参数： s Socket的识别码,addr 存放来连接的彼端的地址,addrlen addr的长度
传回值：
成功 - 新的Socket识别码
失败 - INVALID_SOCKET (呼叫 WSAGetLastError() 可得知原因)
说明：
Server 端的应用程序呼叫此一函数来接受 Client 端要求的 Socket 连接动作请求。

closesocket()
关闭某一Socket。
格式：
int closesocket( SOCKET s );
参数：
s Socket 的识别码
传回值：
成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：
此一函数是用来关闭某一 Socket 。

WSACleanup()
结束 Windows Sockets DLL 的使用。
格式：
int WSACleanup( void );
参数：无
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：当应用程序不再需要使用Windows Sockets DLL 时，须呼叫此一函数来
注销使用，以便释放其占用的资源。

send()
使用连接式（connected）的 Socket 传送资料。
格式：
int send( SOCKET s, const char FAR *buf,
int len, int flags );
参数：
s Socket 的识别码
buf 存放要传送的资料的暂存区
len buf 的长度
flags 此函数被呼叫的方式
传回值：
成功 - 送出的资料长度
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：
此函数用于将信息从本端通过socket发送到远程端。

recv()
自 Socket 接收资料。
格式：
int recv( SOCKET s, char FAR *buf, int len, int flags );
参数：
s Socket 的识别码
buf 存放接收到的资料的暂存区
len buf 的长度
flags 此函数被呼叫的方式
传回值：
成功 - 接收到的资料长度 (若对方 Socket 已关闭，则为 0)
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：
此函数用来自连接式的 Datagram Socket 或 Stream Socket 接收资料。
对 Stream Socket 言，版主们可以接收到目前 input buffer 内有效的资料，但其数量不超过 len 的大小。

WSAStartup()
连结应用程序与 Windows Sockets DLL 的第一个函数。
格式：
int WSAStartup( WORD wVersionRequested,LPWSADATA lpWSAData );
参数： wVersionRequested 可使用的 Windows Sockets API 最高版本
lpWSAData 指向 WSADATA 资料的指标
传回值：
成功 - 0
失败 - WSASYSNOTREADY / WSAVERNOTSUPPORTED / WSAEINVAL
说明：
此函数「必须」是应用程序呼叫到 Windows Sockets DLL 函数中
的第一个，也唯有此函数呼叫成功后，才可以再呼叫其他 Windows Sockets
DLL 的函数。此函数亦让使用者可以指定要使用的 Windows SocketsAPI 版本，及获取设计者的一些信息。

提供之 Windows Sockets API 介面乃是依照 1993年1月20日公布之 WINSOCK 第1.1版(如附录)中所定义之函式 (routine)；
包括了30个Berkeley Software Distribution (BSD) 的函式以及16个符合 Windows Message-driven 特性的函式。

(1) accept()：接受某一Socket的连接要求，以完成 Stream Socket 的连接。
格式： SOCKET PASCAL FAR accept( SCOKET s,struct sockaddr FAR *addr,int FAR *addrlen );
参数： s Socket的识别码 addr 存放来连接的彼端的位址 addrlen addr的长度
传回值：成功 - 新的Socket识别码失败 - INVALID_SOCKET (呼叫 WSAGetLastError() 可得知原因)
说明： Server 端之应用程式呼叫此一函式来接受 Client 端要求之Socket 连接动作；如果Server 端之Socket是为 Blocking 模式，
且没有人要求连接动作，那麽此一函式会Block 函式马上回覆错误。accept() 函式的答覆值为一新的 Socket，此 Socket 不可再用来接受其它的连接要求；但是原先之 Socket 仍可接受其他人的连接要求。

(2) bind()：指定 Socket 的 Local 位址 (Address)。
格式： int PASCAL FAR bind( SOCKET s,const struct sockaddr FAR *name,int namelen );
参数： s Socket的识别码 name Socket的位址值，其格式为namelen name的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此一函式是指定 Local 位址及 Port 给某一未定名之 Socket。使用者若不在意位址或 Port 的值，那麽他可以设定位址为 INADDR_ANY，及Port 为 0；
那麽Windows Sockets 会自动将其设定适当之位址及 Port(1024 到 5000之间的值)，使用者可以在此 Socket 真正连接完成後，呼叫 getsockname() 来获知其被设定的值。

(3) closesocket()：关闭某一Socket。
格式： int PASCAL FAR closesocket( SOCKET s );
参数： s Socket 的识别码
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此一函式是用来关闭某一 Socket。
若是使用者原先对要关闭之 Socket 设定 SO_DONTLINGER，则在呼叫此一函式後，会马上回覆，但是此一 Sokcet 尚未传送完毕的资料会继续送完後才关闭。
若是使用者原先设定此 Socket 为 SO_LINGER，则有两种情况：
(a) Timeout 设为 0 的话，此一 Socket 马上重新设定 (reset)，未传完或未收到的资料全部遗失。
(b) Timeout 不为 0 的话，则会将资料送完，或是等到 Timeout 发生後才关闭。

(4) connect()：要求连接某一Socket到指定的对方。
格式： int PASCAL FAR connect( SOCKET s,const struct sockaddr FAR *name,int namelen );
参数： s Socket 的识别码
name 此 Socket 想要连接的对方位址
namelen name的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫WSAGetLastError()可得知原因)
说明：此函式用来向对方要求建立连接。若是指定的对方位址为 0 的话，会传回错误值。当连接建立完成後，使用者即可利用此一 Socket 来做传送或接收资料之用了。

(5) getpeername()：获取已连接成功之 Socket 的对方位址。
格式： int PASCAL FAR getpeername( SOCKET s,struct sockaddr FAR *name,int FAR *namelen );
参数： s Socket 的识别码
name 此 Socket 连接的对方位址
namelen name 的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式可用来取得已连接成功的 Socket 的彼端之位址资料。

(6) getsockname()：获取 Socket 的 Local 位址资料。
格式： int PASCAL FAR getsockname( SOCKET s,struct sockaddr FAR *name,int FAR *namelen );
参数： s Socket 的识别码
name 此 Socket 的 Local 位址
namelen name 的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式是用来取得已设定位址或已连接之 Socket 的本端位址资料。若是此 Socket 被设定为 INADDR_ANY，则需等真正建立连接成功後才会传回正确的位址。

(7) getsockopt()：要求某一 Socket 目前状态设定的资料。
格式： int PASCAL FAR getsockopt( SOCKET s,int level,int optname,char FAR *optval,int FAR *optlen );
参数： s= Socket的识别码,level=选项设定的,level=optname 选项名称,optval=选项的设定值,optlen=选项设定值的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来获取目前 Socket的某些状态设定值。 WINSOCK 提供之 level 只有 SOL_SOCKET 及 IPPROTO_TCP optname则有以下之选择：(参见WINSOCK 第 29、30 页之定义)
Value Type
----------------------------------------------
SO_ACCEPTCONN BOOL
SO_BROADCAST BOOL
*SO_DEBUG BOOL
SO_DONTLINGER BOOL
*SO_DONTROUTE BOOL
*SO_ERROR int
*SO_KEEPALIVE BOOL
SO_LINGER struct linger FAR*
SO_OOBINLINE BOOL
*SO_RCVBUF int
SO_REUSEADDR BOOL
*SO_SNDBUF int
SO_TYPE int
TCP_NODELAY BOOL
(* 表示暂不提供此功能选项)

(8) htonl()：将一 32 位元 u_long 的值由 host 的排列方式转换成network 的排列方式。
格式： u_long PASCAL FAR htonl( u_long hostlong );
参数： hostlong 一个 32 位元 host 排列方式的数目
传回值：一个 32 位元 network 排列方式的数目
说明：因为 network 的排列方式与 host 的排列方式可能不同，所以我们需要此一函式来做转换。

(9) htons()：将一 16 位元u_short 的值由 host 的排列方式转换成network 的排列方式。
格式： u_short PASCAL FAR htons( u_short hostshort );
参数： hostshort 一个 16 位元 host 排列方式的数目
传回值：一个 16 位元 network 排列方式的数目
说明：因为 network 的排列方式与 host 的排列方式可能不同，所以我们需要此一函式来做转换。
简单地说,htons()就是将一个数的高低位互换
(如:12 34 --> 34 12)
VB表示:
MsgBox Hex(htons(&H1234))
显示值为 3412

(10) inet_addr()：将字串格式的位址转换成 32 位元 unsigned long 的格式。
格式： unsigned long PASCAL FAR inet_addr( const char FAR *cp );
参数： cp 一个代表位址的「点格式」(dotted) 字串
传回值：若无错误发生，inet_addr()返回一个无符号长整型数，其中以适当字节顺序存放Internet地址。
如果传入的字符串不是一个合法的Internet地址，如“a.b.c.d”地址中任一项超过255，那么inet_addr()返回INADDR_NONE
失败 - INADDR_NONE
说明：此函式将一「点格式」的位址字串转换成适用之Intenet位址。
注释：本函数解释cp参数中的字符串，这个字符串用Internet的“.”间隔格式表示一个数字的Internet地址。返回值可用作Internet地址。
所有Internet地址以网络字节顺序返回(字节从左到右排列)。
「点格式」字串可为以下四种方式之任一：
(i) a.b.c.d (ii) a.b.c (iii) a.b (iv) a
当四个部分都有定值时，每个都解释成一个字节数据，从左到右组成Internet四字节地址。请注意，当一个Internet地址在Intel机器上表示成一个32位整型数时，
则上述的字节为“d.c.b.a”。这是因为Intel处理器的字节是从右向左排列的。
请注意：只有Berkeley支持下述表达法，Internet其余各处均不支持。考虑到与软件的兼容性，应按规定进行使用。
对一个三部分地址，最后一部分解释成16位数据并作为网络地址的最右两个字节。这样，三部分地址便很容易表示B组网络地址，如“128.net.host”.
对一个两部分地址，最后一部分解释成24位数据并作为网络地址的最右三个字节，这样，两部分地址便很容易表示C组网络地址，如“net.host”。
对仅有一个部分的地址，则将它的值直接存入网络地址不作任何字节的重组

(11) inet_ntoa()：将一网路位址转换成「点格式」字串。
inet_addr()函数的实现
输入是点分的IP地址格式（如A.B.C.D)的字符串，从该字符串中提取出每一部分，转换为ULONG,假设得到4个ULONG型的A,B,C,D,
ulAddress（ULONG型）是转换后的结果，
ulAddress = D<<24 + C<<16 + B<<8 + A(网络字节序），即inet_addr(const char *)的返回结果
另外，我们也可以得到把该IP转换为主机序的结果，转换方法一样
A<<24 + B<<16 + C<<8 + D
格式： char FAR * PASCAL FAR inet_ntoa( struct in_addr in );
参数： in 一个代表 Internet 位址的结构
传回值：成功 - 一个代表位址的「点格式」(dotted) 字串
失败 - NULL
说明：此函式将一 Internet 位址转换成「a.b.c.d」字串格式。

(12) ioctlsocket()：控制 Socket 的模式。
格式： int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR *argP );
参数： s Socket 的识别码,cmd 指令名称,argP 指向 cmd 参数的指标
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
若无错误发生，inet_ntoa()返回一个字符指针。否则的话，返回NULL。其中的数据应在下一个WINDOWS套接口调用前复制出来。
注释：本函数将一个用in参数所表示的Internet地址结构转换成以“.” 间隔的诸如“a.b.c.d”的字符串形式。请注意inet_ntoa()
返回的字符串存放在WINDOWS套接口实现所分配的内存中。应用程序不应假设该内存是如何分配的。在同一个线程的下一个WINDOWS套接口调用前，数据将保证是有效。
说明：此函式用来获取或设定 Socket 的运作参数。其所提供的指令有：
FIONBIO -- 开关 non-blocking 模式
FIONREAD -- 自 Socket 一次可读取的资料量
SIOCATMARK -- OOB 资料是否已被读取完 (*暂不提供此功能)

(13) listen()：设定 Socket 为监听状态，准备被连接。
格式： int PASCAL FAR listen( SOCKET s, int backlog );
参数： s Socket 的识别码,backlog 未真正完成连接前(尚未呼叫 accept() 前)彼端的连接要求的最大个数
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：使用者可利用此函式来设定 Socket 进入监听状态，并设定最多可有多少个在未真正完成连接前的彼端的连接要求。(目前最大值限制为 5, 最小值为1)

(14) ntohl()：将一 32 位元 u_long 的值由 network 排列方式转换成host 排列方式。
格式： u_long PASCAL FAR ntohl( u_long netlong );
参数： netlong 一个 32 位元 network 排列方式的数目
传回值：一个 32 位元 host 排列方式的数目
说明：因为 network 的排列方式与 host 的排列方式可能不同，所以我们需要此一函式来做转换。

(15) ntohs()：将一 16 位元 u_short 的值由 network 排列方式转换成host 排列方式。
格式： u_short PASCAL FAR ntohs( u_short netshort );
参数： netshort 一个 16 位元 network 排列方式的数目
传回值：一个 16 位元 host 排列方式的数目
说明：因为 network 的排列方式与 host 的排列方式可能不同，所以我们需要此一函式来做转换。

(16) recv()：自 Socket 接收资料。
格式： int PASCAL FAR recv( SOCKET s,char FAR *buf,int len,int flags );
参数： s Socket 的识别码,buf 存放接收到的资料的暂存区,len buf 的长度,flags 此函式被呼叫的方式
传回值：成功 - 接收到的资料长度 (若对方 Socket 已关闭，则为 0)
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来自连接式的 Datagram Socket 或 Stream Socket接收资料。对 Stream Socket 言，我们可以接收到目前有效的 (available)资料，但其数量不超过 len 的大小。若是此 Socket 设定 SO_OOBINLINE

，且有 out-of-band 的资料未被读取，那麽只有 out-of-band 的资料被取出。
对 Datagram Socket 言，只取出第一个 datagram；若是该 datagram 大於使用者提供的储存空间，那麽只有该空间大小的资料被取出，多馀的资料将遗失，且回覆错误的讯息。 flags 的值可为 MSG_PEEK、MSG_OOB(*

暂不提供此功能)的组合.

(17) recvfrom()：读取一个 Datagram，并储存资料来源的位址。
格式： int PASCAL FAR recvfrom( SOCKET s,char FAR *buf,int len,int flags,struct socketaddr FAR *from,int FAR *fromlen );
参数： s Socket 的识别码,buf 存放接收到的资料的暂存区,len buf 的长度,flags 此函式被呼叫的方式,from 资料来源的位址,fromlen from 的大小
传回值：成功 - 接收到的资料长度 (若对方 Socket 已关闭，则为 0)
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来读取资料并记录资料来源的位址。对 Stream Socket 言，其作用与 recv() 相同，参数 from 及 fromlen 将不被用到。

(18) select()：检查一或多个 Sockets 是否处於可读、可写或错误的状态。
格式： int PASCAL FAR select( int nfds,fd_set FAR *readfds,fd_set FAR *writefds,fd_set FAR *exceptfds,const struct timeval FAR *timeout );
参数： nfds 此参数在此并无作用,readfds 要被检查是否可读的 Sockets,writefds 要被检查是否可写的 Sockets,exceptfds 要被检查是否有错误的 Sockets,timeout 此函式该等待的时间。若为 NULL 时，表示

blocking，此函式会等到有事件发生。
传回值：成功 - 符合条件的 Sockets 总数 (若 Timeout 发生，则为 0)
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：使用者可利用此函式来检查 Sockets 是否有资料可被读取，或是有空间可以写入，或是有错误发生。

(19) send()：使用连接式的 Socket 传送资料。
格式： int PASCAL FAR send( SOCKET s,const char FAR *buf,int len,int flags );
参数： s Socket 的识别码,buf 存放要传送的资料的暂存区,len buf 的长度,flags 此函式被呼叫的方式
传回值：成功 - 送出的资料长度
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式适用於连接式的 Datagram 或 Stream Socket 来传送资料。对 Datagram Socket 言，若是 datagram 的大小超过限制，则将不会送出任何资料，并会传回错误值。若是传送 (transport) 系统内之储存

空间不够存放这些要传送的资料，send() 将会被 block 住，除非该 Socket 被设定为 non-blocking 模式。使用者亦须注意 send()函式执行完成，并不表示资料已经成功地送抵对方了。 flags 的值可设为

MSG_DONTROUTE(*暂不提供此功能)及 MSG_OOB 的组合.

(20) sendto()：将资料送到指定的目的地。
格式： int PASCAL FAR sendto( SOCKET s,const char FAR *buf,int len,int flags,const struct sockaddr FAR *to,int tolen );
参数： s Socket 的识别码,buf 存放要传送的资料的暂存区,len buf 的长度,flags 此函式被呼叫的方式,to 资料要送达的位址,tolen to 的大小
传回值：成功 - 送出的资料长度
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式适用於 Datagram 或 Stream Socket 来传送资料到指定的位址。对 Datagram Socket 言，若是 datagram 的大小超过限制，则将不会送出任何资料，并会传回错误值。对 Stream Socket 言，其作用与

send() 相同；参数 to 及 tolen 在此并无作用。若是传送 (transport) 系统内之储存空间不够存放这些要传送的资料，sendto() 将会被 block 住，除非该Socket 被设定为 non-blocking 模式。使用者亦须注意

sendto() 函式执行完成，并不表示资料已经成功地送抵对方了。 flags 的值可设为 MSG_DONTROUTE(*暂不提供此功能)及 MSG_OOB 的组合.

本系统(WinKing)提供之 Windows Sockets API 介面乃是依照 1993年1月20日公布之 WINSOCK 第1.1版(如附录)中所定义之函式 (routine)；包括了30个Berkeley Software Distribution (BSD) 的函式以及16个符合

Windows Message-driven 特性的函式。

(21) setsockopt()：设定 Socket 的状态。
格式： int PASCAL FAR setsockopt( SOCKET s,int level,int optname,const char FAR *optval,int optlen );
参数： s Socket 的识别码,level 选项设定的 level,optname 选项名称,optval 选项的设定值,optlen 选项设定值的长度
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来设定 Socket 的一些选项，藉以更改其动作。
可更改的选项有： (参见WINSOCK第1.1版54页)
Value Type
-----------------------------------------------
SO_BROADCAST BOOL
*SO_DEBUG BOOL
SO_DONTLINGER BOOL
*SO_DONTROUTE BOOL
*SO_KEEPALIVE BOOL
SO_LINGER struct linger FAR*
SO_OOBINLINE BOOL
*SO_RCVBUF int
SO_REUSEADDR BOOL
*SO_SNDBUF int
TCP_NODELAY BOOL

(22) shutdown()：停止 Socket 接收/传送的功能。
格式： int PASCAL FAR shutdown( SOCKET s, int how );
参数： s Socket 的识别码,how 代表该停止那些动作的标帜
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError()可得知原因)
说明：此函式用来停止 Socket 的後续接收或传送的功能。
若 how 的值为 0，则不再接收资料。
若 how 的值为 1，则不再允许传送资料。
若 how 的值为 2，则不再接收且不再传送资料。
shutdown() 函式并没有将 Socket 关闭，所以该 Socket 所占用之资源必须在呼叫closesocket() 之後才会释放。

(23) socket()：建立Socket。
格式： SOCKET PASCAL FAR socket( int af,int type,int protocol );
参数： af 目前只提供 PF_INET(AF_INET),type Socket 的型态 (SOCK_STREAM、SOCK_DGRAM),protocol 通讯协定(如果使用者不指定则设为0)
传回值：成功 - Socket 的识别码
失败 - INVALID_SOCKET(呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来建立一 Socket，并为此 Socket 建立其所使用的资源。
Socket 的型态可为 Stream Socket 或 Datagram Socket。

(24) gethostbyaddr()：利用某一 host 的位址来获取该 host 的资料。
格式： struct hostent FAR * PASCAL FAR gethostbyaddr( const char FAR *addr, int len, int type );
参数： addr network 排列方式的位址,len addr 的长度,type PF_INET(AF_INET)
传回值：成功 - 指向 struct hostent 的指标
struct hostent
{
char FAR * h_name;
char FAR * FAR * h_aliases;
short h_addrtype;
short h_length;
char FAR * FAR * h_addr_list;
}
失败 - NULL (呼叫 WSAGetLastError() 可得知原因)
说明：此函式是利用位址来获取 host的其他资料，如 host 的名称、别名，位址的型态、长度等。

(25) gethostbyname()：利用某一 host 的名称来获取该 host 的资料。
格式： struct hostent FAR * PASCAL FAR gethostbyname( const char FAR *name );
参数： name host 的名称
传回值：成功 - 指向 struct hostent 的指标
struct hostent
{
char FAR * h_name;
char FAR * FAR * h_aliases;
short h_addrtype;
short h_length;
char FAR * FAR * h_addr_list;
}
失败 - NULL (呼叫 WSAGetLastError() 可得知原因)
说明：此函式是利用 host 名称来获取其他的资料，如 host 的位址、别名，位址的型态、长度等。

(26) gethostname()：获取目前使用者使用的 host 的名称。
格式： int PASCAL FAR gethostname( char FAR *name, int namelen );
参数： name 用来存放 host 名称的暂存区,namelen name 的大小
传回值：成功 - 0
失败 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
说明：此函式用来获取 host 的名称。

(27) getprotobyname()：依照通讯协定 (protocol) 的名称来获取该通讯协定的其他资料。
格式： struct protoent FAR * PASCAL FAR getprotobyname( const char FAR *name );
参数： name 通讯协定名称
传回值：成功 - 一指向 struct protoent 的指标
struct protoent
{
char FAR * p_name;
char FAR * FAR * p_aliases;
short p_proto;
}
失败 - NULL (呼叫 WSAGetLastError() 可得知原因)
说明：利用通讯协定的名称来得知该通讯协定的别名、编号等资料。

(28) getprotobynumber()：依照通讯协定的编号来获取该通讯协定的其他资料。
格式： struct protoent FAR * PASCAL FAR getprotobynumber( int number );
参数： number 以 host 排列方式的通讯协定编号
传回值：成功 - 一指向 struct protoent 的指标