Función FreeAddrInfoW (ws2tcpip.h)

La función FreeAddrInfoW libera información de direcciones que la función GetAddrInfoW asigna dinámicamente en estructuras de addrinfoW.

Sintaxis

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Parámetros

[in] pAddrInfo

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

Valor devuelto

Esta función no devuelve un valor.

Observaciones

La función FreeAddrInfoW libera estructuras de addrinfoW asignadas dinámicamente por la función GetAddrInfoW Unicode. La función freeAddrInfoW libera la estructura de addrinfoW inicial que apunta a en el parámetro pAddrInfo, incluidos los búferes a los que apuntan los miembros de la estructura y, a continuación, continúa liberando las estructuras de addrinfoW vinculadas por el miembro ai_next del addrinfoW estructura. La función FreeAddrInfoW continúa liberando estructuras vinculadas hasta que se encuentra un miembroai_next null NULL.

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 pAddrInfo de un puntero de tipo ADDRINFOT. 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 de . Cuando no se define UNICODE o _UNICODE, FreeAddrInfo se define para freeaddrinfo, la versión ANSI de la función y ADDRINFOT se define en la estructura addrinfo.

windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Nota

El encabezado ws2tcpip.h define FreeAddrInfo como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	ws2tcpip.h
biblioteca de	Ws2_32.lib
DLL de	Ws2_32.dll

Consulte también

GetAddrInfoW

funciones winsock

addrinfo

addrinfoW

freeaddrinfo

getaddrinfo