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, o uso de funções tradicionais do Windows Sockets, como a função WSAGetLastError é recomendado.

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.

Valor de retorno

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

Observações

Se o ecode parâmetro 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

WSAGetLastError

do Winsock Functions

referência Winsock

getaddrinfo