FreeAddrInfoEx, fonction (ws2tcpip.h)

  • Article

La fonction FreeAddrInfoEx libère les informations d’adresse que la fonction GetAddrInfoEx alloue dynamiquement dans des structures addrinfoex .

Syntaxe

void WSAAPI FreeAddrInfoEx(
  [in] PADDRINFOEXA 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.

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

Voir aussi

GetAddrInfoEx

addrinfoex