gai_strerrorA 函数 (ws2tcpip.h)

gai_strerror 函数根据 getaddrinfo 函数返回的 EAI_* 错误来帮助打印错误消息。请注意， gai_strerror 函数不是线程安全的，因此建议使用传统的 Windows 套接字函数，例如 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 [仅限桌面应用]
目标平台	Windows
标头	ws2tcpip.h