FreeAddrInfoW-Funktion (ws2tcpip.h)

Artikel
08/28/2023

Die Funktion FreeAddrInfoW gibt Adressinformationen frei, die die GetAddrInfoW-Funktion dynamisch in addrinfoW-Strukturen zuordnet.

Syntax

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Parameter

[in] pAddrInfo

Ein Zeiger auf die addrinfoW-Struktur oder die verknüpfte Liste der zu freigebenden addrinfoW-Strukturen . Der gesamte dynamische Speicher, auf den innerhalb der addrinfoW-Struktur oder -Strukturen verwiesen wird, wird ebenfalls freigegeben.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Die FreeAddrInfoW-Funktion gibt addrinfoW-Strukturen frei, die dynamisch von der Unicode-Funktion GetAddrInfoW zugeordnet werden. Die FreeAddrInfoW-Funktion gibt die anfängliche addrinfoW-Struktur frei, auf die im pAddrInfo-Parameter verwiesen wird, einschließlich aller Puffer, auf die Strukturmember verweisen, und setzt dann die Freigabe aller addrinfoW-Strukturen fort, die durch das ai_next Member der addrinfoW-Struktur verknüpft sind. Die FreeAddrInfoW-Funktion setzt die Freigabe verknüpfter Strukturen fort, bis ein NULL-ai_next Member gefunden wird.

Makros in der Winsock-Headerdatei definieren einen Funktionsnamen mit gemischter Groß-/Kleinschreibung von FreeAddrInfo und eine ADDRINFOT-Struktur . Diese FreeAddrInfo-Funktion sollte mit dem pAddrInfo-Parameter eines Zeigers vom Typ ADDRINFOT aufgerufen werden. Wenn UNICODE oder _UNICODE definiert ist, wird FreeAddrInfo für FreeAddrInfoW, die Unicode-Version der Funktion, und ADDRINFOT für die addrinfoW-Struktur definiert. 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.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Hinweis

Der ws2tcpip.h-Header definiert FreeAddrInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll