1. 程式人生 > >[通訊協議] [Socket程式設計]WSAGetLastError()函式使用講解

[通訊協議] [Socket程式設計]WSAGetLastError()函式使用講解

一.前言        

       WSAGetLastError()函式為我們進行socket程式設計時需要用到的一個函式。

二.講解

     1.函式的功能

  • WSAGetLastError()函式 

        int PASCAL FAR WSAGetLastError ( void );

       返回值指出了該執行緒進行的上一次Windows Sockets API函式呼叫時的錯誤程式碼.這裡使用WSAGetLastError()函式來獲得上一次的錯誤程式碼,而不是依靠全域性錯誤變數, 是為了提供和將來的多執行緒環境相相容.

        注意在一個非佔先的Windows環境下,WSAGetLastError()只用來獲得Windows Sockets API錯誤.在佔先環境下,WSAGetLastError()將呼叫GetLastError(), 來獲得所有在每執行緒基礎上的Win32 API函式的錯誤狀態.為提高可移植性,應用程式應在呼叫失敗後立即使用WSAGetLastError().

         返回值:

6 - WSA_INVALID_HANDLE

指定的事件物件無效。若使用與Win32函式對應的Winsock函式,便有可能產生這樣的Win32錯誤。它表明傳遞給WSAWaitForMultipleEvents的一個控制代碼是無效的。

8 - WSA_NOT_ENOUGH_MEMORY

記憶體不夠。這個Win32錯誤指出記憶體數量不足,無法完成指定的操作。

87 - WSA_INVALID_PARAMETER

一個或多個引數無效。這個Win32錯誤表明傳遞到函式內部的引數無效。假若事件計數引數無效,那麼在執行WSAWaitForMultipleEvents的時候,也會發生這樣的錯誤。

258 - WSA_WAIT_TIMEOUT

操作超時。這個Win32錯誤指出重疊I/O操作未在規定的時間內完成。

995 - WSA_OPERATION_ABORTED

重疊操作被取消。這個Win32錯誤指出由於套接字的關閉,造成一次重疊I/O操作的取消。

除此以外,該錯誤也可能在執行SIO_FLUSH這個I/O控制命令時出現。

996 - WSA_IO_INCOMPLETE

重疊I/O事件物件未處於傳信狀態。這個Win32錯誤也和重疊I/O操作密切相關,在呼叫WSAGetOverlappedResults函式的時候產生,指出重疊I/O操作尚未完成。

997 - WSA_IO_PENDING

重疊操作將在以後完成。用Winsock函式發出一次重疊I/O操作時,若出現這樣的Win32錯誤,便表明操作尚未完成,而且會在以後的某個時間完成。

10004 - WSAEINTR

函式呼叫中斷。該錯誤表明由於對WSACancelBlockingCall的呼叫,造成了一次呼叫被強行中斷。

10009 - WSAEBADF

檔案控制代碼錯誤。該錯誤表明提供的檔案控制代碼無效。在MicrosoftWindowsCE下,socket函式可能返回這個錯誤,表明共享串列埠處於“忙”狀態。

10013 - WSAEACCES

許可權被拒。嘗試對套接字進行操作,但被禁止。若試圖在sendto或WSASendTo中使用一個廣播地址,但是尚未用setsockopt和SO_BROADCAST這兩個選項設定廣播許可權,便會產生這類錯誤。

10014 - WSAEFAULT

地址無效。傳給Winsock函式的指標地址無效。若指定的緩衝區太小,也會產生這個錯誤。

10022 - WSAEINVAL

引數無效。指定了一個無效引數。例如,假如為WSAIoctl呼叫指定了一個無效控制程式碼,便會產生這個錯誤。另外,它也可能表明套接字當前的狀態有錯,例如在一個沒有監聽的套接字上呼叫accept或WSAAccept的時候。

10024 - WSAEMFILE

開啟檔案過多。提示開啟的套接字太多了。通常,Microsoft提供者只受到系統內可用資源數量的限制。

10035 - WSAEWOULDBLOCK

資源暫時不可用。對非阻塞套接字來說,如果請求操作不能立即執行的話,通常會返回這個錯誤。比如說,在一個非阻塞套接字上呼叫connect,就會返回這個錯誤。因為連線請求不能立即執行。

10036 - WSAEINPROGRESS

操作正在進行中。當前正在執行非鎖定操作。一般來說不會出現這個錯誤,除非正在開發16位Winsock應用程式。

10037 - WSAEALREADY

操作已完成。一般來說,在非鎖定套接字上嘗試已處於程序中的操作時,會產生這個錯誤。比如,在一個已處於連線程序的非鎖定套接字上,再一次呼叫connect或WSAConnect。

另外,服務提供者處於執行回撥函式(針對支援回撥例程的Winsock函式)的程序中時也會出現這個錯誤。

10038 - WSAENOTSOCK

無效套接字上的套接字操作。任何一個把SOCKET控制代碼當作引數的Winsock函式都會返回這個錯誤。它表明提供的套接字控制代碼無效。

10039 - WSAEDESTADDRREQ

需要目標地址。這個錯誤表明沒有提供具體地址。比方說,假如在呼叫sendto時,將目標地址設為INADDR_ANY(任意地址),便會返回這個錯誤。

10040 - WSAEMSGSIZE

訊息過長。這個錯誤的含義很多。如果在一個數據報套接字上傳送一條訊息,這條訊息

對內部緩衝區而言太大的話,就會產生這個錯誤。再比如,由於網路自身的限制,使一條訊息過長,也會產生這個錯誤。最後,如果收到資料報之後,緩衝區太小,不能接收訊息時,也會產生這個錯誤。

10041 - WSAEPROTOTYPE

套接字協議型別有誤。在socket或WSASocket呼叫中指定的協議不支援指定的套接字型別。

比如,要求建立SOCK_STREAM型別的一個IP套接字,同時指定協議為IPPROTO_UDP,便會產生這樣的錯誤。

10042 - WSAENOPROTOOPT

協議選項錯誤。表明在getsockopt或setsockopt呼叫中,指定的套接字選項或級別不明、未獲支援或者無效。

10043 - WSAEPROTONOSUPPORT

不支援的協議。系統中沒有安裝請求的協議或沒有相應的實施方案。比如,如果系統中沒有安裝TCP/IP,而試著建立TCP或UDP套接字時,就會產生這個錯誤。

10044 - WSAESOCKTNOSUPPORT

不支援的套接字型別。對指定的地址家族來說,沒有相應的具體套接字型別支援。比如,在向一個不支援原始套接字的協議請求建立一個SOCK_RAW套接字型別時,就會產生這個錯誤。

10045 - WSAEOPNOTSUPP

不支援的操作。表明針對指定的物件,試圖採取的操作未獲支援。通常,如果試著在一

個不支援呼叫Winsock函式的套接字上呼叫了Winsock時,就會產生這個錯誤。比如,在一個數據報套接字上呼叫accept或WSAAccept函式時,就會產生這樣的錯誤。

10046 - WSAEPFNOSUPPORT

不支援的協議家族。請求的協議家族不存在,或系統內尚未安裝。多數情況下,這個錯誤可與WSAEAFNOSUPPORT互換(兩者等價);後者出現得更為頻繁。

10047 - WSAEAFNOSUPPORT

地址家族不支援請求的操作。對套接字型別不支援的操作來說,在試著執行它時,就會出現這個錯誤。比如,在型別為SOCK_STREAM的一個套接字上呼叫sendto或WSASendTo函式時,就會產生這個錯誤。另外,在呼叫socket或WSASocket函式的時候,若同時請求了一個無效的地址家族、套接字型別及協議組合,也會產生這個錯誤。

10048 - WSAEADDRINUSE

下地址正在使用。正常情況下,每個套接字只允許使用一個套接字地址(例如,一個IP套接字地址由本地IP地址及埠號組成)。這個錯誤一般和bind、connect和WSAConnect這三個函式有關。可在setsockopt函式中設定套接字選項SO_REUSEADDR,允許多個套接字訪問同一個本地IP地址及埠號。

10049 - WSAEADDRNOTAVAIL

不能分配請求的地址。API呼叫中指定的地址對那個函式來說無效時,就會產生這樣的錯誤。例如,若在bind呼叫中指定一個IP地址,但卻沒有對應的本地IP介面,便會產生這樣的錯誤。另外,通過connect、WSAConnect、sendto、WSASendTo和WSAJoinLeaf這四個函式為準備連線的遠端計算機指定埠0時,也會產生這樣的錯誤。

10050 - WSAENETDOWN

網路斷開。試圖採取一項操作時,卻發現網路連線中斷。這可能是由於網路堆疊的錯誤,網路介面的故障,或者本地網路的問題造成的。

10051 - WSAENETUNREACH

網路不可抵達。試圖採取一項操作時,卻發現目標網路不可抵達(不可訪問)。這意味著本地主機不知道如何抵達一個遠端主機。換言之,目前沒有已知的路由可抵達那個目標主機。

10052 - WSAENETRESET

網路重設時斷開了連線。由於“保持活動”操作檢測到一個錯誤,造成網路連線的中斷。

若在一個已經無效的連線之上,通過setsockopt函式設定SO_KEEPALIVE選項,也會出現這樣的錯誤。

10053 - WSAECONNABORTED

軟體造成連線取消。由於軟體錯誤,造成一個已經建立的連線被取消。典型情況下,這意味著連線是由於協議或超時錯誤而被取消的。

10054 - WSAECONNRESET

連線被對方重設。一個已經建立的連線被遠端主機強行關閉。若遠端主機上的程序異常中止執行(由於記憶體衝突或硬體故障),或者針對套接字執行了一次強行關閉,便會產生這樣的錯誤。針對強行關閉的情況,可用SO_LINGER套接字選項和setsockopt來配置一個套接字。

10055 - WSAENOBUFS

沒有緩衝區空間。由於系統缺少足夠的緩衝區空間,請求的操作不能執行。

10056 - WSAEISCONN

套接字已經連線。表明在一個已建立連線的套接字上,試圖再建立一個連線。要注意的是,資料報和資料流套接字均有可能出現這樣的錯誤。使用資料報套接字時,假如事先已通過connect或WSAConnect呼叫,為資料報通訊關聯了一個端點的地址,那麼以後試圖再次呼叫sendto或WSASendTo,便會產生這樣的錯誤。

10057 - WSAENOTCONN

套接字尚未連線。若在一個尚未建立連線的“面向連線”套接字上發出資料收發請求,便會產生這樣的錯誤。

10058 - WSAESHUTDOWN

套接字關閉後不能傳送。表明已通過對shutdown的一次呼叫,部分關閉了套接字,但事後又請求進行資料的收發操作。要注意的是,這種錯誤只會在已經關閉的那個資料流動方向上才會發生。舉個例子來說,完成資料傳送後,若呼叫shutdown,那麼以後任何資料傳送呼叫都會產生這樣的錯誤。

10060 - WSAETIMEDOUT

連線超時。若發出了一個連線請求,但經過規定的時間,遠端計算機仍未作出正確的響應(或根本沒有任何響應),便會發生這樣的錯誤。要想收到這樣的錯誤,通常需要先在套接字上設定好SO_SNDTIMEO和SO_RCVTIMEO選項,然後呼叫connect及WSAConnect函式。

要想了解在套接字上設定SO_SNDTIMEO和SO_RCVTIMEO選項的詳情,可參考第9章。

10061 - WSAECONNREFUSED

連線被拒。由於被目標機器拒絕,連線無法建立。這通常是由於在遠端機器上,沒有任何應用程式可在那個地址之上,為連線提供服務。

10064 - WSAEHOSTDOWN

主機關閉。這個錯誤指出由於目標主機關閉,造成操作失敗。然而,應用程式此時更有可能收到的是一條WSAETIMEDOUT(連線超時)錯誤,因為對方關機的情況通常是在試圖建立一個連線的時候發生的。

10065 - WSAEHOSTUNREACH

沒有到主機的路由。應用程式試圖訪問一個不可抵達的主機。該錯誤類似於WSAENETUNREACH。

10067 - WSAEPROCLIM

程序過多。有些Winsock服務提供者對能夠同時訪問它們的程序數量進行了限制。

10091 - WSASYSNOTREADY

網路子系統不可用。呼叫WSAStartup時,若提供者不能正常工作(由於提供服務的基層系統不可用),便會返回這種錯誤。

10092 - WSAVERNOTSUPPORTED

Winsock.dll版本有誤。表明不支援請求的Winsock提供者版本。

10093 - WSANOTINITIALISED

Winsock尚未初始化。尚未成功完成對WSAStartup的一次呼叫。

10101 - WSAEDISCON

正在從容關閉。這個錯誤是由WSARecv和WSARecvFrom返回的,指出遠端主機已初始化了一次從容關閉操作。該錯誤是在像ATM這樣的“面向訊息”協議上發生的。

10102 - WSAENOMORE

找不到更多的記錄。這個錯誤自WSALookupServiceNext函式返回,指出已經沒有留下更多的記錄。這個錯誤通常可與WSA_E_NO_MORE互換使用。在應用程式中,應同時檢查這個錯誤以及WSA_E_NO_MORE。

10103 - WSAECANCELLED

操作被取消。這個錯誤指出當WSALookupServiceNext呼叫仍在處理期間,發出了對WSALookupServiceEnd(服務中止)的一個呼叫。此時,WSALookupServiceNext便會返回這個錯誤。這個錯誤程式碼可與WSA_E_CANCELLED互換使用。作為應用程式,應同時檢查這個錯誤以及WSA_E_CANCELLED

10105 - WSAEINVALIDPROVIDER

無效的服務提供者。這個錯誤同服務提供者關聯在一起,在提供者不能建立正確的Winsock版本,從而無法正常工作的前提下產生。

10106 - WSAEPROVIDERFAILEDINIT

提供者初始化失敗。這個錯誤同服務提供者關聯在一起,通常見於提供者不能載入需要的DLL時。

10107 - WSASYSCALLFAILURE

系統呼叫失敗。表明絕對不應失敗的一個系統呼叫卻令人遺憾地失敗了。

10108 - WSASERVICE_NOT_FOUND

找不到這樣的服務。這個錯誤通常與註冊和名字解析函式相關,在查詢服務時產生(第10章對這些函式進行了詳盡解釋)。該錯誤表明,在給定的名字空間內,找不到請求的服務。

10109 - WSATYPE_NOT_FOUND

找不到類的型別。該錯誤也與註冊及名字解析函式關聯在一起,在處理服務類(Service Class)時發生。若註冊好一個服務的例項,它必須引用一個以前通過WSAInstallServiceClass安裝好的服務。

10110 - WSA_E_NO_MORE

找不到更多的記錄。這個錯誤是自WSALookupServiceNext呼叫返回的,指出已經沒有剩

下的記錄。該錯誤通常可與WSAENOMORE互換使用。作為一個應用程式,應同時檢查這個

錯誤以及WSAENOMORE。

10111 - WSA_E_CANCELLED

操作被取消。該錯誤指出在對WSALookupServiceNext的呼叫尚未完成的時候,又發出了對WSALookupServiceEnd(中止服務)的一個呼叫。這樣,WSALookupServiceNext就會返回該錯誤。這個錯誤程式碼可與WSAECANCELLED互換使用。作為一個應用程式,應同時檢查這個錯誤以及WSAECANCELLED。

10112 - WSAEREFUSED

查詢被拒。由於被主動拒絕,所以一個數據庫查詢操作失敗。

11001 - WSAHOST_NOT_FOUND

主機沒有找到。這個錯誤是在呼叫gethostbyname和gethostbyaddr時產生的,表明沒有找到一個授權應答主機(AuthoritativeAnswerHost)。

11002 - WSATRY_AGAIN

非授權主機沒有找到。這個錯誤也是在呼叫gethostbyname和gethostbyaddr時產生的,表明沒有找到一個非授權主機,或者遇到了伺服器故障。

11003 - WSANO_RECOVERY

遇到一個不可恢復的錯誤。這個錯誤也是在呼叫gethostbyname和gethostbyaddr時產生的,指出遇到一個不可恢復的錯誤,應再次嘗試操作。

11004 - WSANO_DATA

沒有找到請求型別的資料記錄。這個錯誤也是在呼叫gethostbyname和gethostbyaddr時產生的,指出儘管提供的名字有效,但卻沒有找到與請求型別對應的資料記錄。

11005 - WSA_QOS_RECEIVERS

至少有一條預約訊息抵達。這個值同IP服務質量(QoS)有著密切的關係,其實並不是一個真正的“錯誤”(QoS的詳情見第12章)。它指出網路上至少有一個程序希望接收QoS通訊。

11006 - WSA_QOS_SENDERS

至少有一條路徑訊息抵達。這個值同QoS關聯在一起,其實更像一種狀態報告訊息。它指出在網路上,至少有一個程序希望進行QoS資料的傳送。

11007 - WSA_QOS_NO_SENDERS

沒有QoS傳送者。這個值同QoS關聯在一起,指出不再有任何程序對QoS資料的傳送有興趣。請參閱第12章,瞭解在發生這樣的錯誤時,對所發生情況的一系列完整說明。

11008 - WSA_QOS_NO_RECEIVERS

沒有QoS接收者。這個值同QoS關聯在一起,指出不再有任何程序對QoS資料的接收有興趣。請參閱第12章,查閱對這個錯誤的完整說明。

11009 - WSA_QOS_REQUEST_CONFIRMED

預約請求已被確認。QoS應用可事先發出請求,希望在批准了自己對網路頻寬的預約請求後,收到通知。若發出了這樣的請求,一旦批准,便會收到這樣的訊息。請參閱第12章,瞭解對此訊息的詳細說明。

11010 - WSA_QOS_ADMISSION_FAILURE

缺乏資源致錯。資源不夠,以至於無法滿足QoS頻寬請求。

11011 - WSA_QOS_POLICY_FAILURE

證書無效。表明發出QoS預約請求的時候,要麼使用者並不具備正確的許可權,要麼提供的證書無效。

11012 - WSA_QOS_BAD_STYLE

未知或衝突的樣式。QoS應用程式可針對一個指定的會話,建立不同的過濾器樣式。若出現這一錯誤,表明指定的樣式型別要麼未知,要麼存在衝突。請參閱第12章,瞭解對過濾器樣式的詳細說明。

11013 - WSA_QOS_BAD_OBJECT

無效的FILTERSPEC結構或者提供者特有物件。假如為QoS物件提供的FILTERSPEC結構無效,或者提供者特有的緩衝區無效,便會返回這樣的錯誤,詳見第12章。

11014 - WSA_QOS_TRAFFIC_CTRL_ERROR

FLOWSPEC有問題。假如通訊控制組件發現指定的FLOWSPEC引數存在問題(作為QoS物件的一個成員傳遞),便會返回這樣的錯誤。

11015 - WSA_QOS_GENERIC_ERROR

  2.函式使用     

     ①.原型:

#include <winsock.h>
int PASCAL FAR WSAGetLastError ( void );