Função FreeAddrInfoW (ws2tcpip.h)

A função FreeAddrInfoW libera informações de endereço que a função GetAddrInfoW aloca dinamicamente em estruturas addrinfoW .

Sintaxe

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Parâmetros

[in] pAddrInfo

Um ponteiro para a estrutura addrinfoW ou lista vinculada de estruturas de addrinfoW a serem liberadas. Todo o armazenamento dinâmico apontado dentro do estrutura ou estruturas de addrinfoW também é liberado.

Valor de retorno

Essa função não retorna um valor.

Observações

A função FreeAddrInfoW libera estruturas de addrinfoW alocadas dinamicamente pela função de GetAddrInfoW Unicode. A função FreeAddrInfoW libera a estrutura de addrinfoW inicial apontada no parâmetro pAddrInfo , incluindo quaisquer buffers aos quais os membros da estrutura apontam e continua liberando quaisquer estruturas addrinfoW vinculadas pelo membro ai_next da estrutura addrinfoW. A função FreeAddrInfoW continua liberando estruturas vinculadas até que um membroai_next NULL seja encontrado.

As macros no arquivo de cabeçalho Winsock definem um nome de função de maiúsculas e minúsculas de FreeAddrInfo e uma estrutura ADDRINFOT. Essa função FreeAddrInfo deve ser chamada com o parâmetro pAddrInfo de um ponteiro do tipo ADDRINFOT. Quando UNICODE ou _UNICODE é definido, FreeAddrInfo é definido como FreeAddrInfoW, a versão Unicode da função e ADDRINFOT é definido como a estrutura addrinfoW. Quando UNICODE ou _UNICODE não é definido, FreeAddrInfo é definido como freeaddrinfo, a versão ANSI da função e ADDRINFOT é definido como a estrutura addrinfo.

windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store no Windows 8.1, Windows Server 2012 R2 e posterior.

Nota

O cabeçalho ws2tcpip.h define FreeAddrInfo 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 2003 [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

GetAddrInfoW

do Winsock Functions

de addrinfo

addrinfoW

freeaddrinfo

getaddrinfo