常见网络错误代码解释

陈少举

2005-8-23, 23:43 PM

扩号中的为错误代码。

按 Ctrl + F 键，然后输入您遇的错误代码，就可以快速查找到解释。WSAEACCES (10013) Permission denied.

试图使用被禁止的访问权限去访问套接字。例如，在没有使用函数setsockopt()的SO_BROADCAST命令设置广播权限的套接字上使用函数sendto()给一个广播地址发送数据。

WSAEADDRINUSE (10048) Address already in use.

正常情况下每一个套接字地址（协议／IP地址／端口号）只允许使用一次。当应用程序试图使用bind()函数将一个被已存在的或没有完全关闭的或正在关闭的套接字使用了的IP地址／端口号绑扎到一个新套接字上时，该错误发生。对于服务器应用程序来说，如果需要使用bind()函数将多个套接字绑扎到同一个端口上，可以考虑使用setsockopt()函数的SO_REUSEADDR命令。客户应用程序一般不必使用bind()函数——connect()函数总是自动选择没有使用的端口号。当bind()函数操作的是通配地址（包括ADDR_ANY）时，错误WSAEADDRINUSE可能延迟到一个明确的地址被提交时才发生。这可能在后续的函数如connect()、listen()、WSAConnect()或WSAJoinLeaf()调用时发生。

WSAEADDRNOTAVAIL (10049) Cannot assign requested address.

被请求的地址在它的环境中是不合法的。通常地在bind()函数试图将一个本地机器不合法的地址绑扎到套接字时产生。它也可能在connect()、sendto()、WSAConnect()、WSAJoinLeaf()或WSASendTo()函数调用时因远程机器的远程地址或端口号非法（如0地址或0端口号）而产生。

WSAEAFNOSUPPORT (10047) Address family not supported by protocol family.

使用的地址与被请求的协议不兼容。所有的套接字在创建时都与一个地址族（如IP协议对应的AF_INET）和一个通用的协议类型（如SOCK_STREAM）联系起来。如果在socket()调用中明确地要求一个不正确的协议，或在调用sendto()等函数时使用了对套接字来说是错误的地址族的地址，该错误返回。

WSAEALREADY (10037) Operation already in progress.

当在非阻塞套接字上已经有一个操作正在进行时，又有一个操作试图在其上执行则产生此错误。如：在一个正在进行连接的非阻塞套接字上第二次调用connect()函数；或取消一个已经被取消或已完成的异步请求（WSAAsyncGetXbyY()）。

WSAECONNABORTED (10053) Software caused connection abort.

一个已建立的连接被你的主机上的软件终止，可能是因为一次数据传输超时或是协议错误。

WSAECONNREFUSED (10061) Connection refused.

因为目标主机主动拒绝，连接不能建立。这通常是因为试图连接到一个远程主机上不活动的服务，如没有服务器应用程序处于执行状态。

WSAECONNRESET (10054) Connection reset by peer.

存在的连接被远程主机强制关闭。通常原因为：远程主机上对等方应用程序突然停止运行，或远程主机重新启动，或远程主机在远程方套接字上使用了“强制”关闭（参见setsockopt(SO_LINGER)）。另外，在一个或多个操作正在进行时，如果连接因“keep-alive”活动检测到一个失败而中断，也可能导致此错误。此时，正在进行的操作以错误码WSAENETRESET失败返回，后续操作将失败返回错误码WSAECONNRESET。

WSAEDESTADDRREQ (10039) Destination address required.

在套接字上一个操作所必须的地址被遗漏。例如，如果sendto()函数被调用且远程地址为ADDR_ANY时，此错误被返回。

WSAEFAULT (10014) Bad address.

系统检测到调用试图使用的一个指针参数指向的是一个非法指针地址。如果应用

程序传递一个非法的指针值，或缓冲区长度太小，此错误发生。例如，参数为结构sockaddr，但参数的长度小于sizeof(struct sockaddr)。

WSAEHOSTDOWN (10064) Host is down.

套接字操作因为目的主机关闭而失败返回。套接字操作遇到不活动主机。本地主机上的网络活动没有初始化。这些条件由错误码WSAETIMEDOUT指示似乎更合适。WSAEHOSTUNREACH (10065) No route to host.

试图和一个不可达主机进行套接字操作。参见WSAENETUNREACH。

WSAEINPROGRESS (10036) Operation now in progress.

一个阻塞操作正在执行。Windows Sockets只允许一个任务（或线程）在同一时间可以有一个未完成的阻塞操作，如果此时调用了任何函数（不管此函数是否引用了该套接字或任何其它套接字），此函数将以错误码WSAEINPROGRESS返回。

WSAEINTR (10004) Interrupted function call.

阻塞操作被函数WSACancelBlockingCall ()调用所中断。

WSAEINVAL (10022) Invalid argument.

提供了非法参数（例如，在使用setsockopt()函数时指定了非法的level）。在一些实例中，它也可能与套接字的当前状态相关，例如，在套接字没有使用listen()使其处于监听时调用accept()函数。

WSAEISCONN (10056) Socket is already connected.

连接请求发生在已经连接的套接字上。一些实现对于在已连接SOCK_DGRAM套接字上使用sendto()函数的情况也返回此错误（对于SOCK_STREAM套接字，sendto()

函数的to参数被忽略），尽管其它一些实现将此操作视为合法事件。

WSAEMFILE (10024) Too many open files.

打开了太多的套接字。不管是对整个系统还是每一进程或线程，Windows Sockets 实现都可能有一个最大可用的套接字句柄数。

WSAEMSGSIZE (10040) Message too long.

在数据报套接字上发送的一个消息大于内部消息缓冲区或一些其它网络限制，或者是用来接受数据报的缓冲区小于数据报本身。

WSAENETDOWN (10050) Network is down.

套接字操作遇到一个不活动的网络。此错误可能指示网络系统（例如WinSock DLL 运行的协议栈）、网络接口或本地网络本身发生了一个严重的失败。

WSAENETRESET (10052) Network dropped connection on reset.

在操作正在进行时连接因“keep-alive”检测到失败而中断。也可能由setsockopt()函数返回，如果试图使用它在一个已经失败的连接上设置

SO_KEEPALIVE。

dldavid1024

2005-8-24, 08:54 AM

不错，比较实用，多谢少举的发布。

加为精华。