Función FreeAddrInfoEx (ws2tcpip.h)

  • Artículo

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

Consulte también

GetAddrInfoEx

addrinfoex