Função freeaddrinfo (ws2tcpip.h)

Artigo
03/13/2024

A função freeaddrinfo libera informações de endereço que a função getaddrinfo aloca dinamicamente em estruturas addrinfo .

Sintaxe

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Parâmetros

[in] pAddrInfo

Um ponteiro para a estrutura addrinfo ou lista vinculada de estruturas addrinfo a serem liberadas. Todo o armazenamento dinâmico apontado dentro da estrutura ou estrutura addrinfo também é liberado.

Retornar valor

Essa função não retorna um valor.

Comentários

A função freeaddrinfo libera estruturas addrinfo alocadas dinamicamente pela função getaddrinfo ANSI. A função freeaddrinfo libera a estrutura addrinfo inicial apontada no parâmetro ai , incluindo quaisquer buffers para os quais os membros da estrutura apontam e continua liberando quaisquer estruturas addrinfo vinculadas pelo membro ai_next da estrutura addrinfo . A função freeaddrinfo continua liberando estruturas vinculadas até que um membro nuloai_next seja encontrado.

As macros no arquivo de cabeçalho Winsock definem um nome de função de caso misto de FreeAddrInfo e uma estrutura ADDRINFOT . Essa função FreeAddrInfo deve ser chamada com o parâmetro ai de um ponteiro do tipo ADDRINFOT. Quando UNICODE ou _UNICODE não está definido, FreeAddrInfo é definido como freeaddrinfo, a versão ANSI da função e ADDRINFOT é definido para a estrutura addrinfo . Quando UNICODE ou _UNICODE é definido, FreeAddrInfo é definido como FreeAddrInfoW, a versão Unicode da função e ADDRINFOT é definido para a estrutura addrinfoW .

Suporte para freeaddrinfo em versões anteriores do Windows

A função freeaddrinfo foi adicionada ao Ws2_32.dll no Windows XP e posterior.

A função FreeAddrInfoW é a versão Unicode do freeaddrinfo. A função FreeAddrInfoW foi adicionada ao Ws2_32.dll no Windows XP com Service Pack 2 (SP2). A função FreeAddrInfoW não pode ser usada em versões do Windows anteriores ao Windows XP com SP2.

Windows Phone 8: a função freeaddrinfo tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: as funções freeaddrinfo e FreeAddrInfoW têm suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	ws2tcpip.h
DLL	Ws2_32.dll