Função freeaddrinfo (ws2tcpip.h)
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 |