다음을 통해 공유


RtlIpv4AddressToStringA 함수(ip2string.h)

RtlIpv4AddressToString 함수는 IPv4 주소를 인터넷 표준 점선 소수점 형식의 문자열로 변환합니다.

구문

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

매개 변수

[in] Addr

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

[out] S

IPv4 주소의 NULL로 종료된 문자열 표현을 저장할 버퍼에 대한 포인터입니다. 이 버퍼는 16자 이상을 수용할 수 있을 만큼 커야 합니다.

반환 값

IPv4 주소의 문자열 표현 끝에 삽입된 NULL 문자에 대한 포인터입니다. 이는 호출자가 문자열에 더 많은 정보를 쉽게 추가하는 데 사용할 수 있습니다.

설명

RtlIpv4AddressToString 함수는 IPv4 주소를 인터넷 점선 10진수 형식의 IPv4 주소의 문자열 표현으로 변환하는 데 사용됩니다.

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

UNICODE 또는 _UNICODE 정의되면 RtlIpv4AddressToString 이 이 함수의 유니코드 버전인 RtlIpv4AddressToStringW에 정의됩니다. 문자열 매개 변수 S 및 함수 반환 값은 PWSTR 데이터 형식에 정의됩니다.

UNICODE와 _UNICODE 모두 정의되지 않은 경우 RtlIpv4AddressToString 은 이 함수의 ANSI 버전인 RtlIpv4AddressToStringA에 정의됩니다. 문자열 매개 변수 S 및 함수 반환 값은 PSTR 데이터 형식에 정의됩니다.

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

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

참고

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

요구 사항

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

추가 정보

GetModuleHandle

GetProcAddress

InetNtop

InetPton

LoadLibrary

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

RtlIpv6StringToAddressEx

inet_addr

inet_ntoa