FreeAddrInfoW, fonction (ws2tcpip.h)

Article
11/20/2024

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

Syntaxe

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Paramètres

[in] pAddrInfo

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

Valeur de retour

Cette fonction ne retourne pas de valeur.

Remarques

La fonction FreeAddrInfoW libère structures addrinfoW allouées dynamiquement par la fonction GetAddrInfoW Unicode. La fonction FreeAddrInfoW libère la structure initiale addrinfoW pointée dans le paramètre pAddrInfo, y compris les mémoires tampons auxquelles les membres de la structure pointent, puis continue à libérer les structures addrinfoW liées par le membre ai_next de la structure addrinfoW. La fonction FreeAddrInfoW continue de libérer des structures liées jusqu’à ce qu’un membre NULLai_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. Lorsque unicode ou _UNICODE est défini, FreeAddrInfo est défini sur freeAddrInfoW, la version Unicode de la fonction et addRINFOT est définie sur la structure addrinfoW . Quand UNICODE ou _UNICODE n’est pas défini, freeAddrInfo est défini sur freeaddrinfo, la version ANSI de la fonction et ADDRINFOT est définie 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.

Note

L’en-tête ws2tcpip.h définit FreeAddrInfo 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. 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	ws2tcpip.h
bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll