Поделиться через


функция gai_strerrorA (ws2tcpip.h)

Функция gai_strerror помогает в печати сообщений об ошибках на основе ошибок EAI_*, возвращаемых функцией getaddrinfo. Обратите внимание, что функция gai_strerror не является потокобезопасной, поэтому рекомендуется использовать традиционные функции сокетов Windows, такие как функция WSAGetLastError.

Синтаксис

char * gai_strerrorA(
  [in] int ecode
);

Параметры

[in] ecode

Код ошибки из списка доступных кодов ошибок getaddrinfo. Полный список кодов ошибок см. в функции getaddrinfo.

Возвращаемое значение

Возвращает указатель на строку, содержащую сообщение об ошибке.

Замечания

Если параметр ecode не является значением кода ошибки, которое возвращает getaddrinfo, функция gai_strerror возвращает указатель на строку, которая указывает на неизвестная ошибка.

Заметка

Заголовок ws2tcpip.h определяет gai_strerror как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка ws2tcpip.h

См. также

WSAGetLastError

Функции Winsock

Справочник Winsock

getaddrinfo