Fonction FreeAddrInfoW (ws2tcpip.h)

Article
03/04/2024

La fonction FreeAddrInfoW libère les informations d’adresse que la fonction GetAddrInfoW alloue dynamiquement dans les structures addrinfoW .

Syntaxe

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Paramètres

[in] pAddrInfo

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

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La fonction FreeAddrInfoW libère les structures addrinfoW allouées dynamiquement par la fonction Unicode GetAddrInfoW . La fonction FreeAddrInfoW libère la structure addrinfoW 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 addrinfoW liées par le membre ai_next de la structure addrinfoW . La fonction FreeAddrInfoW 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 pAddrInfo d’un pointeur de type ADDRINFOT. 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 . 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 .

Windows 8.1 et Windows Server 2012 R2 : cette fonction 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 FreeAddrInfo comme un 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. Le mélange 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 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	ws2tcpip.h
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll