winsock中函数.docVIP

Winsock函数说明 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