Função FreeAddrInfoEx (ws2tcpip.h)
A função FreeAddrInfoEx libera informações de endereço que a função GetAddrInfoEx aloca dinamicamente em estruturas addrinfoex .
Sintaxe
void WSAAPI FreeAddrInfoEx(
[in] PADDRINFOEXA pAddrInfoEx
);
Parâmetros
[in] pAddrInfoEx
Um ponteiro para a estrutura addrinfoex ou lista vinculada de estruturas addrinfoex a serem liberadas. Todo o armazenamento dinâmico apontado dentro da estrutura ou estrutura addrinfoex também é liberado.
Retornar valor
Essa função não retorna um valor.
Comentários
A função FreeAddrInfoEx libera estruturas addrinfoex alocadas dinamicamente pela função GetAddrInfoEx . A função FreeAddrInfoEx libera a estrutura addrinfoex inicial apontada no parâmetro pAddrInfo , incluindo quaisquer buffers para os quais os membros da estrutura apontam e continua liberando quaisquer estruturas addrinfoex vinculadas pelo membro ai_next da estrutura addrinfoex . A função FreeAddrInfoEx continua liberando estruturas vinculadas até que um membro nuloai_next seja encontrado.
Quando UNICODE ou _UNICODE é definido, FreeAddrInfoEx é definido como FreeAddrInfoExW, a versão Unicode da função e ADDRINFOEX é definido para a estrutura addrinfoexW . Quando UNICODE ou _UNICODE não está definido, FreeAddrInfoEx é definido como FreeAddrInfoExA, a versão ANSI da função e ADDRINFOEX é definida para a estrutura addrinfoexA .
Windows 8.1 e Windows Server 2012 R2: a função FreeAddrInfoExW tem 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 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | ws2tcpip.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |