RtlIpv6StringToAddressA 함수(ip2string.h)

RtlIpv6StringToAddress 함수는 IPv6 주소의 문자열 표현을 이진 IPv6 주소로 변환합니다.

통사론

NTSYSAPI NTSTATUS RtlIpv6StringToAddressA(
  [in]  PCSTR    S,
  [out] PCSTR    *Terminator,
  [out] in6_addr *Addr
);

매개 변수

[in] S

IPv6 주소의 NULL종료된 문자열 표현을 포함하는 버퍼에 대한 포인터입니다.

[out] Terminator

변환된 문자열을 종료한 문자에 대한 포인터를 받는 매개 변수입니다. 호출자가 문자열에서 자세한 정보를 추출하는 데 사용할 수 있습니다.

[out] Addr

IPv6 주소의 이진 표현을 저장할 포인터입니다.

반환 값

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

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

발언

RtlIpv6StringToAddress 함수는 IPv6 주소의 문자열 표현을 네트워크 순서로 반환된 IPv6 주소(왼쪽에서 오른쪽으로 정렬된 바이트)로 변환하는 데 사용됩니다.

rtlIpv6StringToAddress Windows 소켓 DLL을 로드하여 Windows 소켓에 제공된 함수에 액세스하여 문자열을 IP 주소 변환으로 수행할 필요가 없는 편리한 함수입니다.

S 매개 변수가 가리키는 문자열은 IPv6 주소 문자열의 형식으로 표현되어야 합니다. IPv6 주소의 기본 문자열 표현은 콜론으로 구분된 8개의 16진수로 구성됩니다. 연속된 0개의 숫자 문자열을 이중 콜론으로 바꿀 수 있습니다. IPv6 주소의 문자열 표현에는 이중 콜론이 하나만 있을 수 있습니다. 주소가 IPv4 호환 주소, IPv4 매핑된 IPv6 주소 또는 ISATAP 주소인 경우 마지막 32비트는 IPv4 스타일 점선 옥텟 표기법으로 표시될 수 있습니다. 자세한 내용은 IETF에서 게시한 RFC 5942 섹션 5를 참조하세요.

성공하면 Terminator 매개 변수는 변환된 문자열을 종료한 문자를 가리킵니다. 이렇게 하면 애플리케이션이 포함된 문자열과 IP 주소 및 추가 정보를 RtlIpv6StringToAddress 함수에 전달한 다음 나머지 정보를 구문 분석할 수 있습니다.