Compartilhar via


função gai_strerrorA (ws2tcpip.h)

A função gai_strerror auxilia na impressão de mensagens de erro com base nos erros de EAI_* retornados pela função getaddrinfo . Observe que a função gai_strerror não é thread-safe e, portanto, é recomendável usar funções tradicionais do Windows Sockets, como a função WSAGetLastError .

Sintaxe

char * gai_strerrorA(
  [in] int ecode
);

Parâmetros

[in] ecode

Código de erro da lista de códigos de erro getaddrinfo disponíveis. Para obter uma listagem completa de códigos de erro, consulte a função getaddrinfo .

Retornar valor

Retorna um ponteiro para uma cadeia de caracteres que contém a mensagem de erro.

Comentários

Se o parâmetro ecode não for um valor de código de erro que getaddrinfo retorna, a função gai_strerror retornará um ponteiro para uma cadeia de caracteres que indica um erro desconhecido.

Observação

O cabeçalho ws2tcpip.h define gai_strerror como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2tcpip.h

Confira também

Wsagetlasterror

Funções Winsock

Referência de Winsock

Getaddrinfo