gai_strerrorA函式（ws2tcpip.h）

gai_strerror 函式會根據 getaddrinfo 函式所傳回的 EAI_* 錯誤，協助列印錯誤訊息。請注意，gai_strerror 函式不是安全線程，因此建議使用傳統 Windows Sockets 函式，例如 WSAGetLastError 函式。

語法

char * gai_strerrorA(
  [in] int ecode
);

[in] ecode

可用 getaddrinfo 清單中的錯誤碼錯誤碼。如需錯誤碼的完整清單，請參閱 getaddrinfo 函式。

傳回包含錯誤訊息的字串指標。

如果 ecode 參數不是 getaddrinfo 傳回的錯誤碼值，gai_strerror 函式會傳回指出未知錯誤的字元串指標。

注意

ws2tcpip.h 標頭會將gai_strerror定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ws2tcpip.h