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 [仅限桌面应用]
目标平台 窗户
标头 ws2tcpip.h

另请参阅

WSAGetLastError

Winsock 函数

Winsock 参考

getaddrinfo