freeaddrinfo 함수(ws2tcpip.h)

아티클
03/13/2024

freeaddrinfo 함수는 getaddrinfo 함수가 addrinfo 구조에서 동적으로 할당하는 주소 정보를 해제합니다.

구문

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

매개 변수

[in] pAddrInfo

해제할 addrinfo 구조체 또는 연결된 addrinfo 구조 목록에 대한 포인터입니다. addrinfo 구조체 또는 구조체 내에서 가리키는 모든 동적 스토리지도 해제됩니다.

반환 값

이 함수는 값을 반환하지 않습니다.

설명

freeaddrinfo 함수는 ANSI getaddrinfo 함수에 의해 동적으로 할당된 addrinfo 구조를 해제합니다. freeaddrinfo 함수는 구조체 멤버가 가리키는 버퍼를 포함하여 ai 매개 변수에서 가리키는 초기 addrinfo 구조를 해제한 다음, addrinfo 구조체의 ai_next 멤버에 의해 연결된 모든 addrinfo 구조를 계속 해제합니다. freeaddrinfo 함수는 NULLai_next 멤버가 발생할 때까지 연결된 구조를 계속 해제합니다.

Winsock 헤더 파일의 매크로는 FreeAddrInfo 의 혼합 사례 함수 이름과 ADDRINFOT 구조를 정의합니다. 이 FreeAddrInfo 함수는 ADDRINFOT 형식의 포인터에 대한 ai 매개 변수를 사용하여 호출해야 합니다. UNICODE 또는 _UNICODE 정의되지 않은 경우 FreeAddrInfo 는 함수의 ANSI 버전인 freeaddrinfo로 정의되고 ADDRINFOT 는 addrinfo 구조에 정의됩니다. UNICODE 또는 _UNICODE 정의되면 FreeAddrInfo 는 함수의 유니코드 버전 인 FreeAddrInfoW에 정의되고 ADDRINFOT 는 addrinfoW 구조에 정의됩니다.

이전 버전의 Windows에서 freeaddrinfo 지원

freeaddrinfo 함수가 Windows XP 이상에서 Ws2_32.dll 추가되었습니다.

FreeAddrInfoW 함수는 freeaddrinfo의 유니코드 버전입니다. FreeAddrInfoW 함수가 Windows XP SP2(서비스 팩 2)의 Ws2_32.dll 추가되었습니다. FreeAddrInfoW 함수는 WINDOWS XP SP2 이전 버전의 Windows에서 사용할 수 없습니다.

Windows Phone 8:freeaddrinfo 함수는 Windows Phone 8 이상에서 Windows Phone 스토어 앱에 대해 지원됩니다.

Windows 8.1 및 Windows Server 2012 R2: Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에 대해 freeaddrinfo 및 FreeAddrInfoW 함수가 지원됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1, Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	ws2tcpip.h
DLL	Ws2_32.dll