FreeAddrInfoW Function
The FreeAddrInfoW function frees address information that the GetAddrInfoW function dynamically allocates in addrinfoW structures.
Syntax
void WSAAPI FreeAddrInfoW(
__in PADDRINFOW pAddrInfo
);
Parameter
- pAddrInfo [in]
A pointer to the addrinfoW structure or linked list of addrinfoW structures to be freed. All dynamic storage pointed to within the addrinfoW structure or structures is also freed.
Rückgabewert
Funktion gibt keinen Wert zurück.
Hinweise
The FreeAddrInfoW function frees addrinfoW structures dynamically allocated by the Unicode GetAddrInfoW function. The FreeAddrInfoW function frees the initial addrinfoW structure pointed to in the pAddrInfo parameter, including any buffers to which structure members point, then continues freeing any addrinfoW structures linked by the ai_next member of the addrinfoW structure. The FreeAddrInfoW function continues freeing linked structures until a NULL ai_next member is encountered.
Macros in the Winsock header file define a mixed-case function name of FreeAddrInfo and an ADDRINFOT structure. This FreeAddrInfo function should be called with the pAddrInfo parameter of a pointer of type ADDRINFOT. When UNICODE or _UNICODE is defined, FreeAddrInfo is defined to FreeAddrInfoW, the Unicode version of the function, and ADDRINFOT is defined to the addrinfoW structure. When UNICODE or _UNICODE is not defined, FreeAddrInfo is defined to freeaddrinfo, the ANSI version of the function, and ADDRINFOT is defined to the addrinfo structure.
Anforderungen
Mindestens unterstützter Client |
Windows Vista, Windows XP with SP2 |
Mindestens unterstützter Server |
Windows Server 2003 |
Header |
Ws2tcpip.h |
Bibliothek |
Ws2_32.lib |
DLL |
Ws2_32.dll |