FreeAddrInfoExW-Funktion (ws2tcpip.h)

Die FreeAddrInfoEx-Funktion gibt Adressinformationen frei, die die GetAddrInfoEx-Funktion dynamisch in addrinfoex-Strukturen ordnet.

Syntax

void WSAAPI FreeAddrInfoExW(
  [in] PADDRINFOEXW pAddrInfoEx
);

Parameter

[in] pAddrInfoEx

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

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

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

Wenn UNICODE oder _UNICODE definiert ist, wird FreeAddrInfoEx fürFreeAddrInfoExW, die Unicode-Version der Funktion, und ADDRINFOEX für die addrinfoexW-Struktur definiert. Wenn UNICODE oder _UNICODE nicht definiert ist, wird FreeAddrInfoEx fürFreeAddrInfoExA, die ANSI-Version der Funktion, und ADDRINFOEX für die addrinfoexA-Struktur definiert.

Windows 8.1 und Windows Server 2012 R2: Die FreeAddrInfoExW-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 FreeAddrInfoEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	ws2tcpip.h
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll

Weitere Informationen

GetAddrInfoEx

addrinfoex