当前位置:
文档之家› Windows Sockets 错误码及出错原因
Windows Sockets 错误码及出错原因
WSAEMSGSIZE
EMSGSIZE
10040
同BSD
WSAEPROTOTYPE
EPROTOTYPE
10041
同BSD
WSAENOPROTOOPT
ENOPROTOOPT
10042
同BSD
WSAEPROTONOSUPPORT
EPROTONOSUPPORT
10043
同BSD
WSAESOCKTNOSUPPORT
NO_RECOVERY
11003
同BSD
WSANO_DATA
NO_DATA
11004
同BSD
A.2Windows Sockets错误码扩展描述
下面给出WSAGetLastError()函数返回的可能错误码按字母顺序排列的列表,同时给出简要的扩展描述。
WSAEACCES (10013) Permission denied.
WSAEDESTADDRREQ (10039) Destination address required.
在套接字上一个操作所必须的地址被遗漏。例如,如果sendto()函数被调用且远程地址为ADDR_ANY时,此错误被返回。
WSAEFAULT (10014) Bad address.
系统检测到调用试图使用的一个指针参数指向的是一个非法指针地址。如果应用程序传递一个非法的指针值,或缓冲区长度太小,此错误发生。例如,参数为结构sockaddr,但参数的长度小于sizeof(struct sockaddr)。
试图和一个不可达主机进行套接字操作。参见WSAENETUNREACH。
WSAEINPROGRESS (10036) Operation now in progress.
一个阻塞操作正在执行。Windows Sockets只允许一个任务(或线程)在同一时间可以有一个未完成的阻塞操作,如果此时调用了任何函数(不管此函数是否引用了该套接字或任何其它套接字),此函数将以错误码WSAEINPROGRESS返回。
WSAEAFNOSUPPORT (10047) Address family not supported by protocol family.
使用的地址与被请求的协议不兼容。所有的套接字在创建时都与一个地址族(如IP协议对应的AF_INET)和一个通用的协议类型(如SOCK_STREAM)联系起来。如果在socket()调用中明确地要求一个不正确的协议,或在调用sendto()等函数时使用了对套接字来说是错误的地址族的地址,该错误返回。
WSAECONNABORTED (10053) Software caused connection abort.
一个已建立的连接被你的主机上的软件终止,可能是因为一次数据传输超时或是协议错误。
WSAECONNREFUSED (10061) Connection refused.
因为目标主机主动拒绝,连接不能建立。这通常是因为试图连接到一个远程主机上不活动的服务,如没有服务器应用程序处于执行状态。
EBADF
10009
同标准C
WSAEACCES
EACCES
10013
同标准C
WSAEFAULT
EFAULT
10014
同标准C
WSAEINVAL
EINVAL
10022
同标准C
WSAEMFILE
EMFILE
10024
同标准C
WSAEWOULDBLOCK
EWOULDBLOCK
10035
同BSD
WSAEINPROGRESS
由WSAStartup()返回,指示网络子系统无法使用。
WSAVERNOTSUPPORTED
10092
由WSAStartup()返回,指示Windows Sockets
DLL不能支持此应用程序。
WSANOTINITIALISED
10093
由除WSAStartup()之外的其它函数返回,指示尚没有一次成功的WSAStartup()调用执行过。
10048
同BSD
WSAEADDRNOTAVAIL
EADDRNOTAVAIL
10049
同BSD
WSAENETDOWN
ENETDOWN
10050
同BSD。任何时候只要Windows Sockets实现检测到网络子系统失败,它就报告此错误。
WSAENETUNREACH
ENETUNREACH10051同源自SD10061同BSD
WSAELOOP
ELOOP
10062
同BSD
WSAENAMETOOLONG
ENAMETOOLONG
10063
同BSD
WSAEHOSTDOWN
EHOSTDOWN
10064
同BSD
WSAEHOSTUNREACH
EHOSTUNREACH
10065
同BSD
WSASYSNOTREADY
10091
EINPROGRESS
10036
当一个阻塞函数正在进行时,调用任何Windows Sockets API函数均返回此错误
WSAEALREADY
EALREADY
10037
同BSD
WSAENOTSOCK
ENOTSOCK
10038
同BSD
WSAEDESTADDRREQ
EDESTADDRREQ
10039
同BSD
WSAENOTCONN
ENOTCONN
10057
同BSD
WSAESHUTDOWN
ESHUTDOWN
10058
同BSD
WSAETOOMANYREFS
ETOOMANYREFS
10059
同BSD
WSAETIMEDOUT
ETIMEDOUT
10060
同BSD
WSAECONNREFUSED
ECONNREFUSED
WSAEDISCON
10101
由WSARecv()和WSARecvFrom()返回,指示远程方已经初始化了一个“雅致”的shutdown序列。
WSAHOST_NOT_FOUND
HOST_NOT_FOUND
11001
同BSD
WSATRY_AGAIN
TRY_AGAIN
11002
同BSD
WSANO_RECOVERY
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错误码
Windows Sockets错误码
Berkeley对应错误码
错误号
解释
WSAEINTR
EINTR
10004
同标准C
WSAEBADF
ESOCKTNOSUPPORT
10044
同BSD
WSAEOPNOTSUPP
EOPNOTSUPP
10045
同BSD
WSAEPFNOSUPPORT
EPFNOSUPPORT
10046
同BSD
WSAEAFNOSUPPORT
EAFNOSUPPORT
10047
同BSD
WSAEADDRINUSE
EADDRINUSE
WSAEALREADY (10037) Operation already in progress.
当在非阻塞套接字上已经有一个操作正在进行时,又有一个操作试图在其上执行则产生此错误。如:在一个正在进行连接的非阻塞套接字上第二次调用connect()函数;或取消一个已经被取消或已完成的异步请求(WSAAsyncGetXbyY())。
试图使用被禁止的访问权限去访问套接字。例如,在没有使用函数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()调用时发生。