FreeAddrInfoEx-Funktion (ws2tcpip.h)
Die Funktion FreeAddrInfoEx gibt Adressinformationen frei, die die GetAddrInfoEx-Funktion dynamisch in addrinfoex-Strukturen zuordnet.
Syntax
void WSAAPI FreeAddrInfoEx(
[in] PADDRINFOEXA pAddrInfoEx
);
Parameter
[in] pAddrInfoEx
Ein Zeiger auf die addrinfoex-Struktur oder die verknüpfte Liste der zu freigebenden addrinfoex-Strukturen . Der gesamte dynamische Speicher, auf den innerhalb der addrinfoex-Struktur oder -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 Strukturmember verweisen, und setzt dann die Freigabe aller addrinfoex-Strukturen fort, die durch den 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ür FreeAddrInfoExW, die Unicode-Version der Funktion, und ADDRINFOEX für die addrinfoexW-Struktur definiert. Wenn UNICODE oder _UNICODE nicht definiert ist, wird FreeAddrInfoEx für FreeAddrInfoExA, 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.
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 |