FreeAddrInfoEx Function

The FreeAddrInfoEx function frees address information that the GetAddrInfoEx function dynamically allocates in addrinfoex structures.

Syntax

void WSAAPI FreeAddrInfoEx(
  __in  PADDRINFOEX pAddrInfo
);

Parameter

  • pAddrInfo [in]
    A pointer to the addrinfoex structure or linked list of addrinfoex structures to be freed. All dynamic storage pointed to within the addrinfoex structure or structures is also freed.

Rückgabewert

Funktion gibt keinen Wert zurück.

Hinweise

The FreeAddrInfoEx function frees addrinfoex structures dynamically allocated by the GetAddrInfoEx function. The FreeAddrInfoEx function frees the initial addrinfoex structure pointed to in the pAddrInfo parameter, including any buffers to which structure members point, then continues freeing any addrinfoex structures linked by the ai_next member of the addrinfoex structure. The FreeAddrInfoEx function continues freeing linked structures until a NULL ai_next member is encountered.

When UNICODE or _UNICODE is defined, FreeAddrInfoEx is defined to FreeAddrInfoExW, the Unicode version of the function, and ADDRINFOEX is defined to the addrinfoexW structure. When UNICODE or _UNICODE is not defined, FreeAddrInfoEx is defined to FreeAddrInfoExA, the ANSI version of the function, and ADDRINFOEX is defined to the addrinfoexA structure.

Anforderungen

Mindestens unterstützter Client

Windows Vista

Mindestens unterstützter Server

Windows Server 2008

Header

Ws2tcpip.h

Bibliothek

Ws2_32.lib

DLL

Ws2_32.dll

Unicode- und ANSI-Namen

FreeAddrInfoExW (Unicode) and FreeAddrInfoEx (ANSI)

Siehe auch

addrinfoex

GetAddrInfoEx