FreeAddrInfoExW, fonction (ws2tcpip.h)
La fonction FreeAddrInfoEx libère les informations d’adresse que la fonction GetAddrInfoEx alloue dynamiquement dans des structures addrinfoex .
Syntaxe
void WSAAPI FreeAddrInfoExW(
[in] PADDRINFOEXW pAddrInfoEx
);
Paramètres
[in] pAddrInfoEx
Pointeur vers la structure addrinfoex ou la liste liée des structures addrinfoex à libérer. Tout le stockage dynamique pointé vers la ou les structures addrinfoex est également libéré.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
La fonction FreeAddrInfoEx libère les structures addrinfoex allouées dynamiquement par la fonction GetAddrInfoEx . La fonction FreeAddrInfoEx libère la structure addrinfoex initiale pointée vers le paramètre pAddrInfo , y compris les mémoires tampons vers lesquelles pointent les membres de la structure, puis continue à libérer toutes les structures addrinfoex liées par le membre ai_next de la structure addrinfoex . La fonction FreeAddrInfoEx continue de libérer des structures liées jusqu’à ce qu’un membre null ai_next soit rencontré.
Lorsque unicode ou _UNICODE est défini, FreeAddrInfoEx est défini sur FreeAddrInfoExW, la version Unicode de la fonction, et ADDRINFOEX est défini sur la structure addrinfoexW . Lorsque unicode ou _UNICODE n’est pas défini, FreeAddrInfoEx est défini sur FreeAddrInfoExA, la version ANSI de la fonction, et ADDRINFOEX est défini sur la structure addrinfoexA .
Windows 8.1 et Windows Server 2012 R2 : la fonction FreeAddrInfoExW est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.
Notes
L’en-tête ws2tcpip.h définit FreeAddrInfoEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1, Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | ws2tcpip.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |