Um ponteiro para a estrutura addrinfoex ou lista vinculada de estruturas de addrinfoex a serem liberadas. Todo o armazenamento dinâmico apontado dentro do estrutura ou estruturas de addrinfoex também é liberado.
Valor de retorno
Essa função não retorna um valor.
Observações
A função FreeAddrInfoEx libera estruturas de addrinfoex alocadas dinamicamente pela função GetAddrInfoEx . A função FreeAddrInfoEx libera a estrutura de addrinfoex inicial apontada no parâmetro pAddrInfo , incluindo os buffers aos quais os membros da estrutura apontam e continua liberando as estruturas addrinfoex vinculadas pelo membro ai_next da estrutura addrinfoex . A função FreeAddrInfoEx continua liberando estruturas vinculadas até que um membroai_next NULL seja encontrado.
Quando UNICODE ou _UNICODE é definido, FreeAddrInfoEx é definido como FreeAddrInfoExW, a versão Unicode da função e ADDRINFOEX é definido como a estrutura addrinfoexW. Quando UNICODE ou _UNICODE não é definido, FreeAddrInfoEx é definido como FreeAddrInfoExA, a versão ANSI da função e ADDRINFOEX é definido para a estruturaaddrinfoexA.
windows 8.1 e Windows Server 2012 R2: a função FreeAddrInfoExW tem suporte para aplicativos da Windows Store no Windows 8.1, Windows Server 2012 R2 e posterior.
Nota
O cabeçalho ws2tcpip.h define FreeAddrInfoEx 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 8.1, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo
Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]