fonction freeaddrinfo (ws2tcpip.h)

Article
08/28/2023

La fonction freeaddrinfo libère les informations d’adresse que la fonction getaddrinfo alloue dynamiquement dans des structures addrinfo .

Syntaxe

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Paramètres

[in] pAddrInfo

Pointeur vers la structure addrinfo ou la liste liée des structures addrinfo à libérer. Tout le stockage dynamique pointé vers la ou les structures addrinfo est également libéré.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La fonction freeaddrinfo libère les structures addrinfo allouées dynamiquement par la fonction getaddrinfo ANSI. La fonction freeaddrinfo libère la structure addrinfo initiale pointée vers le paramètre ai , y compris les mémoires tampons vers lesquelles pointent les membres de la structure, puis continue à libérer toutes les structures addrinfo liées par le ai_next membre de la structure addrinfo . La fonction freeaddrinfo continue de libérer les structures liées jusqu’à ce qu’un membre NULL ai_next soit rencontré.

Les macros du fichier d’en-tête Winsock définissent un nom de fonction à casse mixte de FreeAddrInfo et une structure ADDRINFOT . Cette fonction FreeAddrInfo doit être appelée avec le paramètre ai d’un pointeur de type ADDRINFOT. Lorsque UNICODE ou _UNICODE n’est pas défini, FreeAddrInfo est défini sur freeaddrinfo, la version ANSI de la fonction, et ADDRINFOT est défini sur la structure addrinfo . Quand UNICODE ou _UNICODE est défini, FreeAddrInfo est défini sur FreeAddrInfoW, la version Unicode de la fonction, et ADDRINFOT est défini sur la structure addrinfoW .

Prise en charge de freeaddrinfo sur les versions antérieures de Windows

La fonction freeaddrinfo a été ajoutée au Ws2_32.dll sur Windows XP et versions ultérieures.

La fonction FreeAddrInfoW est la version Unicode de freeaddrinfo. La fonction FreeAddrInfoW a été ajoutée au Ws2_32.dll dans Windows XP avec Service Pack 2 (SP2). La fonction FreeAddrInfoW ne peut pas être utilisée sur des versions de Windows antérieures à Windows XP avec SP2.

Windows Phone 8 : la fonction freeaddrinfo est prise en charge pour les applications du Store Windows Phone Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : les fonctions freeaddrinfo et FreeAddrInfoW sont prises 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 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	ws2tcpip.h
DLL	Ws2_32.dll