freeaddrinfo-Funktion (ws2tcpip.h)
Die funktion freeaddrinfo gibt Adressinformationen frei, die die getaddrinfo-Funktion dynamisch in addrinfo-Strukturen ordnet.
Syntax
VOID WSAAPI freeaddrinfo(
[in] PADDRINFOA pAddrInfo
);
Parameter
[in] pAddrInfo
Ein Zeiger auf die addrinfo-Struktur oder die verknüpfte Liste der zu befreienden addrinfo-Strukturen . Der gesamte dynamische Speicher, auf den innerhalb der addrinfo-Struktur bzw. -Strukturen verwiesen wird, wird ebenfalls freigegeben.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Die freeaddrinfo-Funktion gibt addrinfo-Strukturen frei, die dynamisch von der ANSI getaddrinfo-Funktion zugeordnet werden. Die freeaddrinfo-Funktion gibt die anfängliche addrinfo-Struktur frei, auf die im ai-Parameter verwiesen wird, einschließlich aller Puffer, auf die Strukturmitglieder verweisen, und setzt dann die Freigabe aller addrinfo-Strukturen fort, die durch das ai_next Member der addrinfo-Struktur verknüpft sind. Die freeaddrinfo-Funktion setzt die Freigabe verknüpfter Strukturen fort, bis ein NULL-ai_next-Member gefunden wird.
Makros in der Winsock-Headerdatei definieren einen funktionsübergreifenden Namen von FreeAddrInfo und eine ADDRINFOT-Struktur . Diese FreeAddrInfo-Funktion sollte mit dem ai-Parameter eines Zeigers vom Typ ADDRINFOT aufgerufen werden. Wenn UNICODE oder _UNICODE nicht definiert ist, wird FreeAddrInfo für freeaddrinfo, die ANSI-Version der Funktion, und ADDRINFOT für die addrinfo-Struktur definiert. Wenn UNICODE oder _UNICODE definiert ist, wird FreeAddrInfo für FreeAddrInfoW, die Unicode-Version der Funktion, und ADDRINFOT für die addrinfoW-Struktur definiert.
Unterstützung für freeaddrinfo in früheren Versionen von Windows
Die Freeaddrinfo-Funktion wurde dem Ws2_32.dll unter Windows XP und höher hinzugefügt.Die FreeAddrInfoW-Funktion ist die Unicode-Version von freeaddrinfo. Die Funktion FreeAddrInfoW wurde dem Ws2_32.dll in Windows XP mit Service Pack 2 (SP2) hinzugefügt. Die FreeAddrInfoW-Funktion kann nicht in Versionen von Windows vor Windows XP mit SP2 verwendet werden.
Windows Phone 8: Die freeaddrinfo-Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.
Windows 8.1 und Windows Server 2012 R2: Die Funktionen freeaddrinfo und FreeAddrInfoW werden für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ws2tcpip.h |
| DLL | Ws2_32.dll |