FreeAddrInfoW-Funktion (ws2tcpip.h)
Die FreeAddrInfoW Funktion 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 verknüpfte Liste von addrinfoW Strukturen freizugeben. Alle dynamischen Speicher, die innerhalb der addrinfoW Struktur oder Strukturen verweisen, werden ebenfalls freigegeben.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Die FreeAddrInfoW- Funktion gibt addrinfoW- Strukturen dynamisch von der Unicode-GetAddrInfoW-Funktion zugewiesen. Die FreeAddrInfoW--Funktion gibt die ursprüngliche addrinfoW- Struktur frei, auf die im pAddrInfo Parameter verwiesen wird, einschließlich aller Puffer, zu denen Strukturmemberpunkte gehören, und gibt dann alle addrinfoW Strukturen frei, die vom ai_next Member der addrinfoW Struktur verknüpft sind. Die FreeAddrInfoW--Funktion setzt verknüpfte Strukturen fort, bis ein NULL-ai_next-Element gefunden wird.
Makros in der Winsock-Headerdatei definieren einen funktionsübergreifenden Namen von FreeAddrInfo- und einer ADDRINFOT- Struktur. Diese FreeAddrInfo--Funktion sollte mit dem pAddrInfo Parameter eines Zeigers vom Typ ADDRINFOTaufgerufen 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 unter Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anmerkung
Der ws2tcpip.h-Header definiert FreeAddrInfo 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 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 |
|---|---|
| mindestens unterstützte Client- | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | ws2tcpip.h |
| Library | Ws2_32.lib |
| DLL- | Ws2_32.dll |