`

Sockets/Windows Sockets错误码

阅读更多

Sockets/Windows Sockets错误码
Windows Sockets在头文件winsock.h中定义了所有的错误码,它们包括以“WSA”打头的
Windows Sockets实现返回的错误码和Berkeley Sockets定义的错误码全集。定义Berkeley
Sockets错误码是为了确保原有软件的可移植性。
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_set中的成员不合法。
WSAEOPNOTSUPP (10045) Operation not supported.
对于引用的对象的类型来说,试图进行的操作不支持。通常它发生在套接字不支持此操作的
套接字描述符上,例如,试图在数据报套接字上接收连接。
WSAEPFNOSUPPORT (10046) Protocol family not supported.
协议簇没有在系统中配置或没有支持它的实现存在。它与WSAEAFNOSUPPORT有些微的
不同,但在绝大多数情况下是可互换的,返回这两个错误的所有Windows Sockets函数的说
明见WSAEAFNOSUPPORT的描述。
WSAEPROCLIM (10067) Too many processes.
Windows Sockets实现可能限制同时使用它的应用程序的数量,如果达到此限制,
WSAStartup()函数可能因此错误失败。
WSAEPROTONOSUPPORT (10043) Protocol not supported.
请求的协议没有在系统中配置或没有支持它的实现存在。例如,socket()调用请求一个
SOCK_DGRAM套接字,但指定的是流协议。
WSAEPROTOTYPE (10041) Protocol wrong type for socket.
在socket()函数调用中指定的协议不支持请求的套接字类型的语义。例如,ARPA Internet
UDP协议不能和SOCK_STREAM套接字类型一同指定。
WSAESHUTDOWN (10058) Cannot send after socket shutdown.
因为套接字在相应方向上已经被先前的shutdown()调用关闭,因此该方向上的发送或接收请
求不被允许。通过调用shutdown()函数来请求对套接字的部分关闭,它发送一个信号来停止
发送或接收或双向操作。
WSAESOCKTNOSUPPORT (10044) Socket type not supported.
不支持在此地址族中指定的套接字类型。例如,socket()调用中选择了可选的套接字类型
SOCK_RAW,但是实现却根本不支持SOCK_RAW类型的套接字。
WSAETIMEDOUT (10060) Connection timed out.
连接请求因被连接方在一个时间周期内不能正确响应而失败,或已经建立的连接因被连接的
主机不能响应而失败。
WSATYPE_NOT_FOUND (10109) Class type not found
指定的类没有找到。
WSAEWOULDBLOCK (10035) Resource temporarily unavailable.
此错误由在非阻塞套接字上不能立即完成的操作返回,例如,当套接字上没有排队数据可读
时调用了recv()函数。此错误不是严重错误,相应操作应该稍后重试。对于在非阻塞
SOCK_STREAM套接字上调用connect()函数来说,报告WSAEWOULDBLOCK是正常的,
因为建立一个连接必须花费一些时间。
WSAHOST_NOT_FOUND (11001) Host not found.
主机未知。此名字不是一个正式主机名,也不是一个别名,它不能在查询的数据库中找到。
此错误也可能在协议和服务查询中返回,它意味着指定的名字不能在相关数据库中找到。
WSA_INVALID_HANDLE (OS dependent) Specified event object handle is invalid.
应用程序试图使用一个事件对象,但指定的句柄非法。
WSA_INVALID_PARAMETER (OS dependent) One or more parameters are invalid.
应用程序使用了一个直接映射到Win32函数的WinSock函数,而Win32函数指示一个或多
个参数有问题。
WSAINVALIDPROCTABLE (OS dependent) Invalid procedure table from service
provider.
服务提供者返回了一个假的WS2_32.DLL程序(procedure)表。这通常是由一个或多个函数
指针为空引起。
WSAINVALIDPROVIDER (OS dependent) Invalid service provider version number.
服务提供者返回一个不同于2.2的版本号。
WSA_IO_INCOMPLETE (OS dependent) Overlapped I/O event object not in signaled
state.
应用程序试图检测一个没有完成的重叠操作的状态。应用程序使用函数
WSAGetOverlappedResult()(参数fWait设置为false)以轮询模式检测一个重叠操作是否完
成时将得到此错误码,除非该操作已经完成。
WSA_IO_PENDING (OS dependent) Overlapped operations will complete later.
应用程序已经初始化了一个不能立即完成的重叠操作。当稍后此操作完成时将有完成指示。
WSA_NOT_ENOUGH_MEMORY (OS dependent) Insufficient memory available.
应用程序使用了一个直接映射到Win32函数的WinSock函数,而Win32函数指示缺乏必要
的内存资源。
WSANOTINITIALISED (10093) Successful WSAStartup() not yet performed.
应用程序没有调用WSAStartup()函数,或函数WSAStartup()调用失败了。应用程序可能访问
了不属于当前活动任务的套接字(例如试图在任务间共享套接字),或调用了过多的
WSACleanup()函数。
WSANO_DATA (11004) Valid name, no data record of requested type.
请求的名字合法并且在数据库中找到了,但它没有正确的关联数据用于解析。此错误的通常
例子是主机名到地址(使用gethostbyname()或WSAAsyncGetHostByName()函数)的DNS转
换请求,返回了MX(Mail eXchanger)记录但是没有A(Address)记录,它指示主机本身
是存在的,但是不能直接到达。
WSANO_RECOVERY (11003) This is a non-recoverable error.
此错误码指示在数据库查找时发生了某种不可恢复错误。它可能是因为数据库文件(如BSD
兼容的HOSTS、SERVICES或PROTOCOLS文件)找不到,或DNS请求应服务器有严重错
误而返回。
WSAPROVIDERFAILEDINIT (OS dependent) Unable to initialize a service provider.
服务提供者的DLL不能加载(LoadLibrary()失败)或提供者的WSPStartup/NSPStartup函数
失败。
WSASYSCALLFAILURE (OS dependent) System call failure..
当一个不应该失败的系统调用失败时返回。例如,如果WaitForMultipleObjects()调用失败,
或注册的API不能够利用协议/名字空间目录。
WSASYSNOTREADY (10091) Network subsystem is unavailable.
此错误由WSAStartup()函数返回,它表示此时Windows Sockets实现因底层用来提供网络服
务的系统不可用。用户应该检查:
是否有合适的Windows Sockets DLL文件在当前路径中。
是否同时使用了多个WinSock实现。如果有多于一个的WINSOCK DLL在系统
中,必须确保搜索路径中第一个WINSOCK DLL文件是当前加载的网络子系统所
需要的。
查看WinSock实现的文档以确保所有必须的部件都正确地安装并配置好了。
WSATRY_AGAIN (11002) Non-authoritative host not found.
此错误通常是在主机名解析时的临时错误,它意味着本地服务器没有从授权服务器接收到一
个响应。稍后的重试可能会获得成功。
WSAVERNOTSUPPORTED (10092) WINSOCK.DLL version out of range.
当前的WinSock实现不支持应用程序指定的Windows Sockets规范版本。检查是否有旧的
Windows Sockets DLL文件正在被访问。
WSAEDISCON (10101) Graceful shutdown in progress.
由WSARecv()和WSARecvFrom()函数返回,指示远程方已经初始化了一个“雅致”的关闭
序列。
WSA_OPERATION_ABORTED (OS dependent) Overlapped operation aborted.
因为套接字的关闭,一个重叠操作被取消,或是执行了WSAIoctl()函数的SIO_FLUSH
命令。

分享到:
评论

相关推荐

    windows socket错误码及出错原因

    这些错误码可以分为四个部分,即 Windows Sockets 实现返回的错误码、Berkeley Sockets 定义的错误码、Windows Sockets 扩充的错误码和 getXbyY() 函数返回的错误码。 了解 Windows Socket 错误码非常重要,因为...

    《精通Windows Sockets网络编程》源代码

    源代码会包含错误检查和异常处理的实例,如WSAGetLastError函数获取错误码,以及如何优雅地关闭套接字和释放资源。 6. **数据传输**:网络通信中,数据通常需要经过编码和解码。源代码可能会包含序列化和反序列化的...

    Windows Sockets 规范及应用.pdf

    4. **错误处理**:提供了详细的错误码和错误处理机制,帮助开发者定位和解决问题。 5. **高级特性**:随着版本的演进,Windows Sockets还增加了一些高级特性,如异步I/O操作等。 #### 四、Windows Sockets的应用...

    windows_sockets讲解

    1. Microsoft官方文档:https://docs.microsoft.com/zh-cn/windows/win32/api/winsock/ 2. "Winsock Network Programming" by W. Richard Stevens:一本经典的Winsock编程书籍。 3. 在线教程和示例代码:许多编程...

    Windows Sockets规范及应用Windows网络编程接口

    - 使用`WSAGetLastError`获取最近一次错误代码,结合错误码手册理解错误原因。 - 调试工具如Wireshark可以帮助查看网络数据包,排查网络通信问题。 5. **高级主题**: - 阻塞与非阻塞模式:选择合适的模式取决于...

    WindowsSockets规范及应用Windows网络编程接口

    Windows Sockets API使用`WSAGetLastError()`获取最近的错误代码,并通过`WSAErrorString()`将其转换为可读的错误信息。 **五、高级特性** 1. **多线程**: 在多线程环境中,每个线程需要自己的Winsock初始化和清理...

    Windows Sockets 完全进阶

    使用`WSAGetLastError()`获取错误代码,并根据错误码进行错误处理。 2. **调试工具**:Wireshark等网络抓包工具可以帮助分析网络通信,定位Winsock程序中的问题。 ### 五、高级主题 1. **非阻塞I/O**:通过设置套...

    精通Windows Sockets网络开发源码

    5. **错误处理**:学习如何使用WSAGetLastError获取错误代码,并根据错误码进行问题定位和修复。 6. **异步I/O模型**:可能包含WSAAsyncSelect或WSAEventSelect等异步通信方式,以便在不阻塞主线程的情况下处理网络...

    Sockets-2.3.9.3第三方库

    2. **错误处理**:库可能包含对错误码的处理和解释,帮助开发者更好地理解和解决问题。 3. **异步支持**:高级版本的库可能会提供异步I/O或事件驱动编程的能力,让程序可以同时处理多个Socket连接,提高并发性能。 ...

    Windows_Sockets_规范及应用

    - 错误检查:每一步操作后检查返回值,根据错误码调用`WSAGetLastError`获取错误信息。 - 清理工作:在程序结束前,调用`closesocket`关闭Socket,`WSACleanup`终止Winsock库。 8. **VC++实践** - Visual C++...

    C#Sockets聊天和语音

    7. **用户界面(UI)设计**:客户端应用的UI设计,通常使用Windows Forms或WPF框架,提供友好且直观的用户交互界面,如输入框、按钮和聊天窗口。 8. **事件驱动编程**:在C#中,事件驱动编程用于处理用户输入和其他...

    sockets白皮书 --ace的入门经验--避免10个网络编程出错的经验

    设置套接字为非阻塞模式时,未正确处理EAGAIN/EWOULDBLOCK等错误码。**解决方案**:明确区分阻塞和非阻塞模式下套接字的操作方式,并对返回值进行适当检查。 - **错误六**:**缓冲区溢出**。向缓冲区写入超出其容量...

    WSAStartup函数

    WSAStartup 函数的返回值为 0 表示成功,如果返回非 0 值,表示出现错误,需要调用 WSAGetLastError 函数来获取错误码。 可能出现的错误值包括: * WSASYSNOTREADY:基础网络子系统没有准备好网络通信。 * ...

    精彩编程与编程技巧-用Sockets发送电子邮件...

    - **定义**:Windows Socket API,是微软为Windows操作系统提供的网络通信API。 - **特点**: - 支持TCP/IP等多种网络协议。 - 提供低级别的网络访问接口,开发者可以直接控制网络通信细节。 - 包括创建、配置、...

    基于window Sockets网络编程的www客户机的实现

    在IT领域,网络编程是构建分布式系统和互联网应用程序的基础,Window Sockets(通常简称为Winsock)是Windows操作系统中用于网络通信的一种API。本项目基于Visual Studio 2010,实现了基于Winsock的www(World Wide ...

    c# Sockets实现客户端和服务端通信

    - 网络通信中,错误处理非常重要。需要捕获并处理可能的SocketException或其他异常,比如连接断开或超时。 - 当通信结束时,记得调用Socket的Close方法关闭连接,释放资源。 6. **示例代码** - 服务器端代码: ...

    sockets 2th 代码

    TCP(Transmission Control Protocol)是一种面向连接的、可靠的传输协议,它确保数据的顺序传输和错误校验。TCP通过三次握手建立连接,四次挥手断开连接,确保了数据的完整性和可靠性。在SDK中使用TCP Socket编程,...

    Linux和windows通讯

    3. **错误处理**:Linux和Windows的错误处理方式不同,Linux返回错误码,而Windows使用`WSAGetLastError()`获取错误代码。需要适配不同的错误处理机制。 4. **多线程和并发**:Linux使用`pthread`库,Windows有自带...

    windows下C语言socket

    值得注意的是,Windows下的socket编程需要处理错误,例如使用`WSAGetLastError()`检查错误码,并根据需要调用`WSAErrorToString()`将错误码转换为可读的字符串。此外,完成socket操作后记得使用`closesocket()`关闭...

    sockets_tutorial.pdf

    《RPG IV Socket Tutorial》由Scott Klement撰写,是一份专为使用RPG IV编程语言在AS/400或iSeries系统上的程序员设计的网络编程教程,主要讲解如何使用套接字(Sockets)进行TCP通信。教程假设读者已经熟悉RPG IV...

Global site tag (gtag.js) - Google Analytics