freeaddrinfo-Funktion (ws2tcpip.h)

Artikel
03/04/2024

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