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

Confira também

GetAddrInfoEx

addrinfoex