Função FreeAddrInfoExW (ws2tcpip.h)

A função FreeAddrInfoEx libera informações de endereço que a função GetAddrInfoEx aloca dinamicamente em estruturas de addrinfoex.

Sintaxe

void WSAAPI FreeAddrInfoExW(
  [in] PADDRINFOEXW pAddrInfoEx
);

Parâmetros

[in] pAddrInfoEx

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 estrutura addrinfoexA.

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]
da Plataforma de Destino	Windows
cabeçalho	ws2tcpip.h
biblioteca	Ws2_32.lib
de DLL	Ws2_32.dll

Consulte também

GetAddrInfoEx

addrinfoex