Função FreeAddrInfoW (ws2tcpip.h)

Artigo
03/04/2024

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 a lista vinculada de estruturas addrinfoW a serem liberadas. Todo o armazenamento dinâmico apontado dentro da estrutura ou estruturas addrinfoW também é liberado.

Retornar valor

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

Comentários

A função FreeAddrInfoW libera estruturas addrinfoW alocadas dinamicamente pela função GetAddrInfoW unicode. A função FreeAddrInfoW libera a estrutura addrinfoW inicial apontada no parâmetro pAddrInfo , incluindo quaisquer buffers para os 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 membro nuloai_next seja encontrado.

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 para a estrutura addrinfoW . Quando UNICODE ou _UNICODE não está definido, FreeAddrInfo é definido como freeaddrinfo, a versão ANSI da função e ADDRINFOT é definido para a estrutura addrinfo .

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	ws2tcpip.h
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll