RtlIpv4AddressToStringExW 함수(ip2string.h)

아티클
02/01/2024

RtlIpv4AddressToStringEx 함수는 IPv4 주소 및 포트 번호를 인터넷 표준 형식의 문자열로 변환합니다.

구문

NTSYSAPI NTSTATUS RtlIpv4AddressToStringExW(
  [in]      const in_addr *Address,
  [in]      USHORT        Port,
  [out]     PWSTR         AddressString,
  [in, out] PULONG        AddressStringLength
);

매개 변수

[in] Address

네트워크 바이트 순서의 IPv4 주소입니다.

[in] Port

네트워크 바이트 순서 형식의 포트 번호입니다. 이 매개 변수는 선택적 요소입니다.

[out] AddressString

IPv4 주소 및 포트의 NULL로 끝나는 문자열 표현을 수신하는 버퍼에 대한 포인터입니다. 이 버퍼는 최소 INET_ADDRSTRLEN 문자를 저장할 수 있을 만큼 커야 합니다. INET_ADDRSTRLEN 값은 Ws2ipdef.h 헤더 파일에 정의되어 있습니다.

[in, out] AddressStringLength

입력에서 NULL 종결자를 포함하여 AddressString 매개 변수가 가리키는 버퍼에 맞는 문자 수입니다. 출력에서 이 매개 변수에는 AddressString 매개 변수가 가리키는 버퍼에 실제로 기록된 문자 수가 포함됩니다.

반환 값

함수가 성공하면 반환 값이 STATUS_SUCCESS.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드	설명
STATUS_INVALID_PARAMETER	잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 AddressString 또는 AddressStringLength 매개 변수에 NULL 포인터가 전달되면 반환됩니다. AddressString 매개 변수가 가리키는 버퍼의 길이가 IPv4 주소 및 포트의 문자열 표현을 받을 만큼 충분히 크지 않은 경우에도 이 오류가 반환됩니다.
기타	FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

RtlIpv4AddressToStringEx 함수는 IPv4 주소 및 포트 번호를 인터넷 점선 10진수 형식의 IPv4 주소의 문자열 표현과 콜론 문자 및 포트의 문자열 표현으로 변환하는 데 사용됩니다.

RtlIpv4AddressToStringEx 는 Windows 소켓에 제공된 함수에 액세스하기 위해 Windows 소켓 DLL을 로드할 필요가 없는 편리한 함수로, IP 주소를 문자열로 변환합니다.

AddressString 매개 변수가 가리키는 버퍼의 길이가 IPv4 주소 및 포트의 문자열 표현을 받을 만큼 충분히 크지 않으면 RtlIpv4AddressToStringEx는 ERROR_INVALID_PARAMETER 반환하고 AddressStringLength 매개 변수를 필요한 버퍼 길이로 설정합니다.

UNICODE 또는 _UNICODE 정의되면 RtlIpv4AddressToStringEx 는 이 함수의 유니코드 버전인 RtlIpv4AddressToStringExW에 정의됩니다. AddressString 매개 변수는 PWSTR 데이터 형식에 정의됩니다.

UNICODE와 _UNICODE 모두 정의되지 않은 경우 RtlIpv4AddressToStringEx 는 이 함수의 ANSI 버전인 RtlIpv4AddressToStringExA에 정의됩니다. AddressString 매개 변수는 PSTR 데이터 형식에 정의됩니다.

IN_ADDR 구조체는 Inaddr.h 헤더 파일에 정의되어 있습니다.

RtlIpv4AddressToStringEx 함수를 포함하는 가져오기 라이브러리는 Windows Vista용으로 릴리스된 Microsoft SDK(Windows SDK(소프트웨어 개발 키트) SDK)에 포함되지 않습니다. RtlIpv4AddressToStringEx 함수는 WDK(Windows 드라이버 키트)에 포함된 Ntdll.lib 가져오기 라이브러리에 포함되어 있습니다. 애플리케이션은 GetModuleHandle 및 GetProcAddress 함수를 사용하여 Ntdll.dll 함수 포인터를 검색하고 이 함수를 호출할 수도 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	ip2string.h(Mstcpip.h 포함)
라이브러리	ntdll.lib
DLL	ntdll.dll