Compartilhar via


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

Confira também

GetAddrInfoEx

addrinfoex