词条 | connect() |
释义 | § 简述 建立与一个端的连接。 #include <winsock.h> int PASCAL FAR connect( SOCKET s, const struct sockaddr FAR* name, int namelen); s:标识一个未连接套接口的描述字。 name:欲进行连接的端口名。 namelen:名字长度。 § 注释 本函数用于创建与指定外部端口的连接。s参数指定一个未连接的数据报或流类套接口。如套接口未被捆绑,则系统赋给本地关联一个唯一的值,且设置套接口为已捆绑。请注意若名字结构中的地址域为全零的话,则connect()将返回WSAEADDRNOTAVAIL错误。 对于流类套接口(SOCK_STREAM类型),利用名字来与一个远程主机建立连接,一旦套接口调用成功返回,它就能收发数据了。对于数据报类套接口(SOCK_DGRAM类型),则设置成一个缺省的目的地址,并用它来进行后续的send()与recv()调用。 § 返回值 若无错误发生,则connect()返回0。否则的话,返回SOCKET_ERROR错误,应用程序可通过WSAGetLastError()获取相应错误代码。对阻塞套接口而言,若返回值为SOCKET_ERROR则应用程序调用WSAGetLsatError()。如果它指出错误代码为WSAEWOULDBLOCK,则您的应用程序可以: 1.用select(),通过检查套接口是否可写,来确定连接请求是否完成。或者, 2.如果您的应用程序使用基于消息的WSAAsynSelect()来表示对连接事件的兴趣,则当连接操作完成后,您会收到一个FD_CONNECT消息。 错误代码: WSAENOTINITIALISED:在使用此API之前应首先成功地调用WSAStartup()。 WSAENETDOWN:WINDOWS套接口实现检测到网络子系统失效。 WSAEADDRINUSE:所指的地址已在使用中。 WSAEINTR:通过一个WSACancelBlockingCall()来取消一个(阻塞的)调用。 WSAEINPROGRESS:一个阻塞的WINDOWS套接口调用正在运行中。 WSAEADDRNOTAVAIL:在本地机器上找不到所指的地址。 WSAENOTSUPPORT:所指族中地址无法与本套接口一起使用。 WSAECONNREFUSED:连接尝试被强制拒绝。 WSAEDESTADDREQ:需要目的地址。 WSAEFAULT:namelen参数不正确。 WSAEINVAL:套接口没有准备好与一地址捆绑。 WSAEISCONN:套接口早已连接。 WSAEMFILE:无多余文件描述字。 WSAENETUNREACH:当前无法从本主机访问网络。 WSAENOBUFS:无可用缓冲区。套接口未被连接。 WSAENOTSOCK:描述字不是一个套接口。 WSAETIMEOUT:超时时间到。 WSAEWOULDBLOCK:套接口设置为非阻塞方式且连接不能立即建立。可用select()调用对套接口写,因为select()时会进行连接。 参见: accept(), bind(), getsockname(), socket(), select(), WSAAsyncSelect(). |
随便看 |
百科全书收录594082条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。