función freeaddrinfo (ws2tcpip.h)

Artículo
03/13/2024

La función freeaddrinfo libera información de direcciones que la función getaddrinfo asigna dinámicamente en estructuras addrinfo .

Sintaxis

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Parámetros

[in] pAddrInfo

Puntero a la estructura addrinfo o a la lista vinculada de estructuras addrinfo que se liberarán. También se libera todo el almacenamiento dinámico al que apunta dentro de la estructura o estructuras addrinfo .

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

La función freeaddrinfo libera estructuras addrinfo asignadas dinámicamente por la función getaddrinfo de ANSI. La función freeaddrinfo libera la estructura addrinfo inicial a la que apunta el parámetro ai , incluidos los búferes a los que apuntan los miembros de la estructura y, a continuación, continúa liberando las estructuras addrinfo vinculadas por el miembro ai_next de la estructura addrinfo . La función freeaddrinfo continúa liberando estructuras vinculadas hasta que se encuentra un miembro de ai_nextNULL.

Las macros del archivo de encabezado Winsock definen un nombre de función de mayúsculas y minúsculas mixtas de FreeAddrInfo y una estructura ADDRINFOT . Se debe llamar a esta función FreeAddrInfo con el parámetro ai de un puntero de tipo ADDRINFOT. Cuando no se define UNICODE o _UNICODE, FreeAddrInfo se define en freeaddrinfo, la versión ANSI de la función y ADDRINFOT se define en la estructura addrinfo . Cuando se define UNICODE o _UNICODE, FreeAddrInfo se define en FreeAddrInfoW, la versión Unicode de la función y ADDRINFOT se define en la estructura addrinfoW .

Compatibilidad con freeaddrinfo en versiones anteriores de Windows

La función freeaddrinfo se agregó a la Ws2_32.dll en Windows XP y versiones posteriores.

La función FreeAddrInfoW es la versión Unicode de freeaddrinfo. La función FreeAddrInfoW se agregó al Ws2_32.dll en Windows XP con Service Pack 2 (SP2). La función FreeAddrInfoW no se puede usar en versiones de Windows anteriores a Windows XP con SP2.

Windows Phone 8: la función freeaddrinfo es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: las funciones freeaddrinfo y FreeAddrInfoW son compatibles con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1, Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	ws2tcpip.h
Archivo DLL	Ws2_32.dll