Función FreeAddrInfoEx (ws2tcpip.h)
La función FreeAddrInfoEx libera información de direcciones que la función GetAddrInfoEx asigna dinámicamente en estructuras addrinfoex .
Sintaxis
void WSAAPI FreeAddrInfoEx(
[in] PADDRINFOEXA pAddrInfoEx
);
Parámetros
[in] pAddrInfoEx
Puntero a la estructura addrinfoex o a la lista vinculada de estructuras addrinfoex que se van a liberar. También se libera todo el almacenamiento dinámico al que se apunta dentro de la estructura o las estructuras addrinfoex .
Valor devuelto
Esta función no devuelve ningún valor.
Observaciones
La función FreeAddrInfoEx libera estructuras addrinfoex asignadas dinámicamente por la función GetAddrInfoEx . La función FreeAddrInfoEx libera la estructura addrinfoex inicial a la que apunta 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 addrinfoex vinculadas por el miembro ai_next de la estructura addrinfoex . La función FreeAddrInfoEx continúa liberando estructuras vinculadas hasta que se encuentra un miembro de ai_nextNULL.
Cuando se define UNICODE o _UNICODE, FreeAddrInfoEx se define en FreeAddrInfoExW, la versión Unicode de la función y ADDRINFOEX se define en la estructura addrinfoexW . Cuando no se define UNICODE o _UNICODE, FreeAddrInfoEx se define en FreeAddrInfoExA, la versión ANSI de la función y ADDRINFOEX se define en la estructura addrinfoexA .
Windows 8.1 y Windows Server 2012 R2: la función FreeAddrInfoExW es compatible 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 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | ws2tcpip.h |
| Library | Ws2_32.lib |
| Archivo DLL | Ws2_32.dll |