Función FreeAddrInfoExW (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 FreeAddrInfoExW(
[in] PADDRINFOEXW 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.
Nota
El encabezado ws2tcpip.h define FreeAddrInfoEx 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 Convenciones para prototipos de función.
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de