Windows Sockets 错误码

Windows Sockets 错误码及出错原因

 

转载

 

windows sockets 错误码及出错原因[转]

windows sockets在头文件winsock.h中定义了所有的错误码，它们包括以“wsa”打头的windows sockets实现返回的错误码和berkeley sockets定义的错误码全集。定义berkeley sockets错误码是为了确保原有软件的可移植性。

a.1  windows sockets错误码列表

     表a.1列出了wsagetlasterror()函数返回的可能错误码和它们的解释，它们可分为四个部分。

     错误码的第一部分是用来解决在不同的c编译中对标准c错误码的不一致的定义。错误码的第二部分是标准berkeley sockets错误码的windows sockets版本。错误码的第三部分包括特定windows sockets扩充的错误码。错误码的第四部分由windows sockets的getxbyy()和wsaasyncgetxbyy()函数返回，相当于berkeley软件中由变量h_errno返回的错误（事实 上，windows sockets在头文件winsock.h中已将h_error定义成其值为wsagetlasterror()的一个宏），它们相当于由域名服务 （domain name service）返回的各种失败。假如windows sockets实现没有使用域名服务，它将使用最合适的代码。一般地，windows sockets应用程序应该将错误wsahost_not_found和wsano_data解释为指示要害字（名字，地址等）没有找着，而错误 wsatry_again和wsano_recovery是提醒名字服务自身是非操作的。

     错误码由windows sockets 规范定义，在所有同一版本规范的windows sockets兼容实现中，它们是一致的。

表a.1  windows sockets错误码

a.2  windows sockets错误码扩展描述

     下面给出wsagetlasterror()函数返回的可能错误码按字母顺序排列的列表，同时给出简要的扩展描述。

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。

wsaenetunreach              (10051)             network is unreachable.

试图和一个无法到达的网络进行套接字操作。它经常意味着本地软件不知道到达远程主机的路由。

wsaenobufs                        (10055)             no buffer space available.

由于系统缺乏足够的缓冲区空间，或因为队列已满，在套接字上的操作无法执行。

wsaenoprotoopt             (10042)             bad protocol option.

在getsockopt()或setsockopt()调用中，指定了一个未知的、非法的或不支持的选项或层（level）。

wsaenotconn                    (10057)             socket is not connected.

因为套接字没有连接，发送或接收数据的请求不被答应，或者是使用sendto()函数在数据报套接字上发送时没有提供地址。任何其它类型的操作也可以返回此错误，例如，使用setsockopt()函数在一个已重置的连接上设置so_keepalive。

wsaenotsock                    (10038)             socket operation on non-socket.

操作试图不是在套接字上进行。它可能是套接字句柄参数没有引用到一个合法套接字，或者是调用select()函数时，一个fd_se