FreeAddrInfoW 함수(ws2tcpip.h)

아티클
03/04/2024

FreeAddrInfoW 함수는 GetAddrInfoW 함수가 addrinfoW 구조에 동적으로 할당하는 주소 정보를 해제합니다.

구문

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

매개 변수

[in] pAddrInfo

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

반환 값

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

설명

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

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

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

참고

ws2tcpip.h 헤더는 FREEAddrInfo를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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