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 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 |