Export (0) Print
Expand All
Expand Minimize
0 out of 2 rated this helpful - Rate this topic

FreeAddrInfoW function

The FreeAddrInfoW function frees address information that the GetAddrInfoW function dynamically allocates in addrinfoW structures.

Syntax


void WSAAPI FreeAddrInfoW(
  _In_  PADDRINFOW pAddrInfo
);

Parameters

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.

Return value

This function does not return a value.

Remarks

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.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ws2tcpip.h

Library

Ws2_32.lib

DLL

Ws2_32.dll

See also

addrinfo
addrinfoW
freeaddrinfo
getaddrinfo
GetAddrInfoW
Winsock Functions

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.