TCPRecv() / WSAGetLastError() 返回的代码对应错误

漠北雪~狼

注: TCPRecv().

下面列示了用户在 Windows 操作系统上使用 TCP/IP 时，可能最常遇到的错误代码。它不是完整的错误列表。可以在文件 winsock2.h 中找到 WSAGetLastError() 返回的错误。如果您未安装开发环境，则在您的系统上可能未安装此文件。在“Windows 套接字 2 应用程序编程接口”中说明了关于特定函数返回的错误的更多信息。可以从下列 Web 站点获取此规范的副本：http://www.sockets.com/winsock2.htm#Docs。

10004 —WSAEINTR
函数调用中断。该错误表明由于对W S A C a n c e l B l o c k i n g C a l l 的调用，造成了一次调用被强
行中断。

10009 —WSAEBADF

文件句柄错误。该错误表明提供的文件句柄无效。在Microsoft Windows CE 下，s o c k e t 函数可能返回这个错误，表明共享串口处于“忙”状态。

10013 —WSAEACCES

权限被拒。尝试对套接字进行操作，但被禁止。若试图在s e n d t o 或W S A S e n d To 中使用一个广播地址，但是尚未用s e t s o c k o p t 和S O _ B R O A D C A S T 这两个选项设置广播权限，便会产生这类错误。

10014 —WSAEFAULT

地址无效。传给Wi n s o c k 函数的指针地址无效。若指定的缓冲区太小，也会产生这个错误。

10022 —WSAEINVAL
参数无效。指定了一个无效参数。例如，假如为W S A I o c t l 调用指定了一个无效控制代码，便会产生这个错误。另外，它也可能表明套接字当前的状态有错，例如在一个目前没有监听的套接字上调用a c c e p t 或W S A A c c e p t 。

10024 —WSAEMFILE
打开文件过多。提示打开的套接字太多了。通常，M i c r o s o f t 提供者只受到系统内可用资源数量的限制。

10035 —WSAEWOULDBLOCK
资源暂时不可用。对非锁定套接字来说，如果请求操作不能立即执行的话，通常会返回这个错误。比如说，在一个非暂停套接字上调用c o n n e c t ，就会返回这个错误。因为连接请求不能立即执行。

10036 —WSAEINPROGRESS
操作正在进行中。当前正在执行非锁定操作。一般来说不会出现这个错误，除非正在开发1 6 位Wi n s o c k 应用程序。

10037 —WSAEALREADY
操作已完成。一般来说，在非锁定套接字上尝试已处于进程中的操作时，会产生这个错误。比如，在一个已处于连接进程的非锁定套接字上，再一次调用c o n n e c t 或W S A C o n n e c t 。另外，服务提供者处于执行回调函数（针对支持回调例程的Wi n s o c k 函数）的进程中时，也会?出现这个错误。

10038 —WSAENOTSOCK
无效套接字上的套接字操作。任何一个把S O C K E T 句柄当作参数的Wi n s o c k 函数都会返回这个错误。它表明提供的套接字句柄无效。

10039 —WSAEDESTADDRREQ
需要目标地址。这个错误表明没有提供具体地址。比方说，假如在调用s e n d t o 时，将目标地址设为I N A D D R _ A N Y （任意地址），便会返回这个错误。

10040 —WSAEMSGSIZE
消息过长。这个错误的含义很多。如果在一个数据报套接字上发送一条消息，这条消息对内部缓冲区而言太大的话，就会产生这个错误。再比如，由于网络本身的限制，使一条消息过长，也会产生这个错误。最后，如果收到数据报之后，缓冲区太小，不能接收消息时，也会产生这个错误。

10041 —WSAEPROTOTYPE
套接字协议类型有误。在s o c k e t 或W S A S o c k e t 调用中指定的协议不支持指定的套接字类型。比如，要求建立S O C K _ S T R E A M 类型的一个I P 套接字，同时指定协议为I P P R O TO _ U D P ，便会产生这样的错误。

10042 —WSAENOPROTOOPT
协议选项错误。表明在g e t s o c k o p t 或s e t s o c k o p t 调用中，指定的套接字选项或级别不明、未获支持或者无效。

10043 ——WSAEPROTONOSUPPORT
不支持的协议。系统中没有安装请求的协议或没有相应的实施方案。比如，如果系统中没有安装T C P / I P ，而试着建立T C P 或U D P 套接字时，就会产生这个错误。

10044 —WSAESOCKTNOSUPPORT
不支持的套接字类型。对指定的地址家族来说，没有相应的具体套接字类型支持。比如，在向一个不支持原始套接字的协议请求建立一个S O C K _ R AW 套接字类型时，就会产生这个错误。

10045 —WSAEOPNOTSUPP
不支持的操作。表明针对指定的对象，试图采取的操作未获支持。通常，如果试着在一个不支持调用Wi n s o c k 函数的套接字上调用了Wi n s o c k 时，就会产生这个错误。比如，在一个数据报套接字上调用a c c e p t 或W S A A c c e p t 函数时，就会产生这样的错误。

10046 —WSAEPFNOSUPPORT
不支持的协议家族。请求的协议家族不存在，或系统内尚未安装。多数情况下，这个错误可与W S A E A F N O S U P P O RT 互换（两者等价）；后者出现得更为频繁。

10047 —WSAEAFNOSUPPORT
地址家族不支持请求的操作。对套接字类型不支持的操作来说，在试着执行它时，就会出现这个错误。比如，在类型为S O C K _ S T R E A M 的一个套接字上调用s e n d t o 或W S A S e n d To 函数时，就会产生这个错误。另外，在调用s o c k e t 或W S A S o c k e t 函数的时候，若同时请求了一个无效的地址家族、套接字类型及协议组合，也会产生这个错误。

10048 —WSAEADDRINUSE
地址正在使用。正常情况下，每个套接字只允许使用一个套接字地址（例如，一个I P 套接字地址由本地I P 地址及端口号组成）。这个错误一般和b i n d 、c o n n e c t 和W S A C o n n e c t 这三个函数有关。可在s e t s o c k o p t 函数中设置套接字选项S O _ R E U S E A D D R ，允许多个套接字访问同一个本地I P 地址及端口号（详情见第9 章）。

10049 —WSAEADDRNOTAVAIL
不能分配请求的地址。A P I 调用中指定的地址对那个函数来说无效时，就会产生这样的错误。例如，若在b i n d 调用中指定一个I P 地址，但却没有对应的本地I P 接口，便会产生这样的错误。另外，通过c o n n e c t 、W S A C o n n e c t 、s e n d t o 、W S A S e n d To 和W S A J o i n L e a f 这四个函数为准备连接的远程计算机指定端口0 时，也会产生这样的错误。

10050 —WSAENETDOWN
网络断开。试图采取一项操作时，却发现网络连接中断。这可能是由于网络堆栈的错误，网络接口的故障，或者本地网络的问题造成的。

10051 —WSAENETUNREACH
网络不可抵达。试图采取一项操作时，却发现目标网络不可抵达（不可访问）。这意味着本地主机不知道如何抵达一个远程主机。换言之，目前没有已知的路由可抵达那个目标主机。

10052 —WSAENETRESET
网络重设时断开了连接。由于“保持活动”操作检测到一个错误，造成网络连接的中断。若在一个已经无效的连接之上，通过s e t s o c k o p t 函数设置S O _ K E E PA L I V E 选项，也会出现这样的错误。

10053 —WSAECONNABORTED
软件造成连接取消。由于软件错误，造成一个已经建立的连接被取消。典型情况下，这意味着连接是由于协议或超时错误而被取消的。

10054 —WSAECONNRESET
连接被对方重设。一个已经建立的连接被远程主机强行关闭。若远程主机上的进程异常中止运行（由于内存冲突或硬件故障），或者针对套接字执行了一次强行关闭，便会产生这样的错误。针对强行关闭的情况，可用S O _ L I N G E R 套接字选项和s e t s o c k o p t 来配置一个套接字（欲知详情，请参阅第9 章）。

10055 —WSAENOBUFS
没有缓冲区空间。由于系统缺少足够的缓冲区空间，请求的操作不能执行。

10056 —WSAEISCONN

套接字已经连接。表明在一个已建立连接的套接字上，试图再建立一个连接。要注意的是，数据报和数据流套接字均有可能出现这样的错误。使用数据报套接字时，假如事先已通过c o n n e c t 或W S A C o n n e c t 调用，为数据报通信关联了一个端点的地址，那么以后试图再次调用s e n d t o 或W S A S e n d To ，便会产生这样的错误。

10057 —WSAENOTCONN
套接字尚未连接。若在一个尚未建立连接的“面向连接”套接字上发出数据收发请求，便会产生这样的错误。

10058 —WSAESHUTDOWN
套接字关闭后不能发送。表明已通过对s h u t d o w n 的一次调用，部分关闭了套接字，但又请求进行数据的收发操作。要注意的是，这种错误只会在已经关闭的那个数据流动方向上才会发生。举个例子来说，完成数据发送后，若调用s h u t d o w n ，那么以后任何数据发送调用都会产生这样的错误。

10060 —WSAETIMEDOUT
连接超时。若发出了一个连接请求，但经过规定的时间，远程计算机仍未作出正确的响应（或根本没有任何响应），便会发生这样的错误。要想收到这样的错误，通常需要先在套接字上设置好S O _ S N D T I M E O 和S O _ R C V T I M E O 选项，然后调用c o n n e c t 及W S A C o n n e c t 函数。要想了解在套接字上设置S O _ S N D T I M E O 和S O _ R C V T I M E O 选项的详情，可参考第9 章。

10061 —WSAECONNREFUSED
连接被拒。由于被目标机器拒绝，连接无法建立。这通常是由于在远程机器上，没有任何应用程序可在那个地址之上，为连接提供服务。

10064 —WSAEHOSTDOWN
主机关闭。这个错误指出由于目标主机关闭，造成操作失败。然而，应用程序此时更有可能收到的是一条W S A E T I M E D O U T （连接超时）错误，因为对方关机的情况通常是在试图建立一个连接的时候发生的。

10065 —WSAEHOSTUNREACH

没有到主机的路由。应用程序试图访问一个不可抵达的主机。该错误类似于W S A E N E T U N R E A C H 。

10067 —WSAEPROCLIM

进程过多。有些Wi n s o c k 服务提供者对能够同时访问它们的进程数量进行了限制。

10091 —WSASYSNOTREADY
网络子系统不可用。调用W S A S t a r t u p 时，若提供者不能正常工作（由于提供服务的基层系统不可用），便会返回这种错误。

10092 —WSAVERNOTSUPPORTED
Wi n s o c k . d l l 版本有误。表明不支持请求的Wi n s o c k 提供者版本。

10093 —WSANOTINITIALISED
Wi n s o c k 尚未初始化。尚未成功完成对W S A S t a r t u p 的一次调用。

10101 —WSAEDISCON
正在从容关闭。这个错误是由W S A R e c v 和W S A R e c v F r o m 返回的，指出远程主机已初始化了一次从容关闭操作。该错误是在像AT M 这样的“面向消息”协议上发生的。

10102 —WSAENOMORE
找不到更多的记录。这个错误自W S A L o o k u p S e r v i c e N e x t 函数返回，指出已经没有留下更多的记录。这个错误通常可与W S A _ E _ N O _ M O R E 互换使用。在应用程序中，应同时检查这个错误以及W S A _ E _ N O _ M O R E 。

10103 —WSAECANCELLED
操作被取消。这个错误指出当W S A L o o k u p S e r v i c e N e x t 调用仍在处理期间，发出了对W S A L o o k u p S e r v i c e E n d （服务中止）的一个调用。此时，W S A L o o k u p S e r v i c e N e x t 便会返回这个错误。这个错误代码可与W S A _ E _ C A N C E L L E D 互换使用。作为应用程序，应同时检查这个错误以及W S A _ E _ C A N C E L L E D 。

10104 —WSAEINVALIDPROCTABLE
进程调用表无效。该错误通常是在进程表包含了无效条目的情况下，由一个服务提供者返回的。欲知服务提供者的详情，可参考第1 4 章。

10105 —WSAEINVALIDPROVIDER
无效的服务提供者。这个错误同服务提供者关联在一起，在提供者不能建立正确的Wi n s o c k 版本，从而无法正常工作的前提下产生。

10106 —WSAEPROVIDERFAILEDINIT
提供者初始化失败。这个错误同服务提供者关联在一起，通常见于提供者不能载入需要的D L L 时。

10107 —WSASYSCALLFAILURE
系统调用失败。表明绝对不应失败的一个系统调用却令人遗憾地失败了。

10108 —WSASERVICE_NOT_FOUND
找不到这样的服务。这个错误通常与注册和名字解析函数相关，在查询服务时产生（第1 0 章对这些函数进行了详尽解释）。该错误表明，在给定的名字空间内，找不到请求的服务。

10109 —WSATYPE_NOT_FOUND
找不到类的类型。该错误也与注册及名字解析函数关联在一起，在处理服务类（S e r v i c eC l a s s ）时发生。若注册好一个服务的实例，它必须引用一个以前通过W S A I n s t a l l S e r v i c e C l a s s安装好的服务。

10110 —WSA_E_NO_MORE
找不到更多的记录。这个错误是自W S A L o o k u p S e r v i c e N e x t 调用返回的，指出已经没有剩下的记录。该错误通常可与W S A E N O M O R E 互换使用。作为一个应用程序，应同时检查这个错误以及W S A E N O M O R E 。

10111 —WSA_E_CANCELLED
操作被取消。该错误指出在对W S A L o o k u p S e r v i c e N e x t 的调用尚未完成的时候，又发出了对W S A L o o k u p S e r v i c e E n d （中止服务）的一个调用。这样，W S A L o o k u p S e r v i c e N e x t 就会返回该错误。这个错误代码可与W S A E C A N C E L L E D 互换使用。作为一个应用程序，应同时检查这个错误以及W S A E C A N C E L L E D 。

10112 —WSAEREFUSED
查询被拒。由于被主动拒绝，所以一个数据库查询操作失败。

11001 —WSAHOST_NOT_FOUND
主机没有找到。这个错误是在调用g e t h o s t b y n a m e 和g e t h o s t b y a d d r 时产生的，表明没有找到一个授权应答主机（Authoritative Answer Host ）。

11002 —WSATRY_AGAIN
非授权主机没有找到。这个错误也是在调用g e t h o s t b y n a m e 和g e t h o s t b y a d d r 时产生的，表明没有找到一个非授权主机，或者遇到了服务器故障。

11003 —WSANO_RECOVERY
遇到一个不可恢复的错误。这个错误也是在调用g e t h o s t b y n a m e 和g e t h o s t b y a d d r 时产生的，指出遇到一个不可恢复的错误，应再次尝试操作。

11004 —WSANO_DATA
附录C 计Winsock 错误代码计计485 下载?没有找到请求类型的数据记录。这个错误也是在调用g e t h o s t b y n a m e 和g e t h o s t b y a d d r 时产生的，指出尽管提供的名字有效，但却没有找到与请求类型对应的数据记录。

11005 —WSA_QOS_RECEIVERS
至少有一条预约消息抵达。这个值同I P 服务质量（Q o S ）有着密切的关系，其实并不是一个真正的“错误”（Q o S 的详情见第1 2 章）。它指出网络上至少有一个进程希望接收Q o S 通信。

11006 —WSA_QOS_SENDERS
至少有一条路径消息抵达。这个值同Q o S 关联在一起，其实更像一种状态报告消息。它指出在网络上，至少有一个进程希望进行Q o S 数据的发送。

11007 —WSA_QOS_NO_SENDERS
没有Q o S 发送者。这个值同Q o S 关联在一起，指出不再有任何进程对Q o S 数据的发送有兴趣。请参阅第1 2 章，了解在发生这样的错误时，对所发生情况的一系列完整说明。

11008 —WSA_QOS_NO_RECEIVERS
没有Q o S 接收者。这个值同Q o S 关联在一起，指出不再有任何进程对Q o S 数据的接收有兴趣。请参阅第1 2 章，查阅对这个错误的完整说明。

11009 —WSA_QOS_REQUEST_CONFIRMED
预约请求已被确认。Q o S 应用可事先发出请求，希望在批准了自己对网络带宽的预约请求后，收到通知。若发出了这样的请求，一旦批准，便会收到这样的消息。请参阅第1 2 章，了解对此消息的详细说明。

11010 —WSA_QOS_ADMISSION_FAILURE
缺乏资源致错。资源不够，以至于无法满足Q o S 带宽请求。

11011 —WSA_QOS_POLICY_FAILURE
证书无效。表明发出Q o S 预约请求的时候，要么用户并不具备正确的权限，要么提供的证书无效。

11012 —WSA_QOS_BAD_STYLE
未知或冲突的样式。Q o S 应用程序可针对一个指定的会话，建立不同的过滤器样式。若出现这一错误，表明指定的样式类型要么未知，要么存在冲突。请参阅第1 2 章，了解对过滤器样式的详细说明。

11013 —WSA_QOS_BAD_OBJECT
无效的F I LT E R S P E C 结构或者提供者特有对象。假如为Q o S 对象提供的F I LT E R S P E C 结构无效，或者提供者特有的缓冲区无效，便会返回这样的错误，详见第1 2 章。

11014 —WSA_QOS_TRAFFIC_CTRL_ERROR
F L O W S P E C 有问题。假如通信控制组件发现指定的F L O W S P E C 参数存在问题（作为Q o S对象的一个成员传递），便会返回这样的错误。

11015 —WSA_QOS_GENERIC_ERROR
常规Q o S 错误。这是一个比较泛泛的错误；假如其他Q o S 错误都不适合，便返回这个错误。

6 —WSA_INVALID_HANDLE
指定的事件对象无效。若使用与Wi n 3 2 函数对应的Wi n s o c k 函数，便有可能产生这样的Wi n 3 2 错误。它表明传递给W S AWa i t F o r M u l t i p l e E v e n t s 的一个句柄是无效的。

8 —WSA_NOT_ENOUGH_MEMORY
这个Wi n 3 2 错误指出内存数量不足，无法完成指定的操作。

87 —WSA_INVALID_PARAMETER
一个或多个参数无效。这个Wi n 3 2 错误表明传递到函数内部的参数无效。假若事件计数参数无效，那么在执行W S AWa i t F o r M u l t i p l e E v e n t s 的时候，也会发生这样的错误。

258 —WSA_WAIT_TIMEOUT
操作超时。这个Wi n 3 2 错误指出重叠I / O 操作未在规定的时间内完成。

995 —WSA_OPERATION_ABORTED
重叠操作被取消。这个Wi n 3 2 错误指出由于套接字的关闭，造成一次重叠I / O 操作的取消。除此以外，该错误也可能在执行S I O _ F L U S H 这个I / O 控制命令时出现。

996 —WSA_IO_INCOMPLETE
重叠I / O 事件对象未处于传信状态。这个Wi n 3 2 错误也和重叠I / O 操作密切相关，在调用W S A G e t O v e r l a p p e d R e s u l t s 函数的时候产生，指出重叠I / O 操作尚未完成。

997 —WSA_IO_PENDING
重叠操作将在以后完成。用Wi n s o c k 函数发出一次重叠I / O 操作时，若出现这样的Wi n 3 2 错误，便表明操作尚未完成，而且会在以后的某个时间完成。

WSAEINVAL (10022)：无效自变量。它也可以表示套接字的当前状态与要调用的 TCP 函数不兼容，或套接字可能不再有效。
WSAEMFILE (10024)：打开的文件太多。打开的套接字太多。每个实现可以有一个全局、每进程或每线程可用的套接字句柄的最大数目。
WSAEWOULDBLOCK (10035)：资源暂时不可用。从在非分块的套接字上不能立即完成的操作返回此错误。
WSAEINPROGRESS (10036)：正在进行分块“Windows 套接字”操作。“Windows 套接字”仅允许每个任务（或线程）有单个分块操作未完成，并且如果进行任何其它函数调用，则函数由于 WSAEINPROGRESS 而失败。
WSAENOPROTOOPT (10042)：错误协议选项。在 getsockopt() 或 setsockopt() 调用中指定了未知、无效或不受支持的选项或级别。
WSAEADDRINUSE (10048)：地址已经在使用。通常仅允许每个套接字地址（协议／IP 地址／端口）的一种使用。如果应用程序试图将套接字 bind() 至 IP 地址／端口，而该 IP 地址／端口已经用于现有套接字、未正确关闭的套接字或仍处于关闭进程中的套接字，则发生此错误。
WSAENETDOWN (10050)：网络已停止。套接字操作遇到了失效网络。这可能指示网络系统（即，WinSock DLL 溢出的协议堆栈）、网络接口或本地网络本身的严重故障。
WSAENETUNREACH (10051)：网络不可到达。试图对不可到达的网络执行套接字操作。这通常表示本地软件知道没有到达远程主机的路由。
WSAENETRESET (10052)：网络复位时删除了连接。由于该操作正在进行时“保持活动”活动检测到故障，已中断连接。如果试图在已经失败的连接中设置 SO_KEEPALIVE，则也可能是由 stsockopt() 返回的。
WSAECONNABORTED (10053)：软件导致了连接异常终止。可能由于数据传送超时或协议错误，机器上的软件异常终止了已建立的连接，
WSAECONNRESET (10054)：连接由对等设备复位。远程对等设备强制关闭了现有连接。如果远程机器上的对等应用程序突然停止，机器重新引导，或对等应用程序在远程套接字中使用了“硬关闭”，则通常会导致此结果。如果由于一个或多个操作正在进行时“保持活动”活动检测到故障而中断连接，则也可能导致此错误。正在进行的操作由于 WSAENETRESET 而失败。后续操作由于 WSAECONNRESET 而失败。
WSAENOBUFS (10055)：没有可用缓冲区空间。因为系统缺乏足够缓冲区空间或由于队列已满，所以可能无法执行套接字上的操作。
WSAENOTCONN (10057)：未连接套接字。
WSAETIMEDOUT (10060)：连接超时。因为在一段时间后连接的一方未正确响应，所以连接尝试失败。
WSAECONNREFUSED (10061)：连接已被拒绝。如果正在尝试连接至实例或连接至数据库，则检查是否已成功启动服务器上的数据库管理器和 TCP/IP 协议支持。
WSAEHOSTUNREACH (10065)：没有至主机的路由。试图对不可到达的机器执行套接字操作。
WSASYSNOTREADY (10091)：基础网络子系统未准备好进行网络通信。用户应该检查相应的“Windows 套接字 DLL”是否位于当前路径中，并检查它们是否未尝试同时使用多个 WinSock 实现。如果在您的系统上存在多个 WinSock DLL，则确保路径中的第一个 WinSock DLL 适合于当前已装入的网络子系统，并确保当前已安装并已正确配置所有必要的组件。
WSAVERNOTSUPPORTED (10092)：此特定的“Windows 套接字”实现未提供请求的“Windows 套接字 API”支持的版本。检查是否未访问旧的“Windows 套接字 DLL”文件。
WSA_E_NO_MORE (10110), WSAENOMORE (10102)：没有可用数据。在“Windows 套接字”版本 2 中，为 WSAENOMORE 和 WSA_E_NO_MORE 定义了冲突的错误代码。在以后版本中将除去错误代码 WSAENOMORE，只有 WSA_E_NO_MORE 将保留。
WSAHOST_NOT_FOUND (11001)：找不到主机。
WSATRY_AGAIN (11002)：找不到主机。因为本地机器未接收到来自名称服务器的响应，所以请求从名称服务器中检索主机名的 IP 地址失败。
WSANO_DATA (11004)：名称无效，没有请求的类型的数据记录。名称服务器或 hosts 文件不识别主机名，或者在 services 文件中未指定服务名。