Fungsi RtlIpv6StringToAddressExA (ip2string.h)

Fungsi RtlIpv6StringToAddressEx mengonversi representasi string alamat IPv6, ID cakupan, dan nomor port ke alamat IPv6 biner, ID cakupan, dan port.

Syntax

NTSYSAPI NTSTATUS RtlIpv6StringToAddressExA(
  [in]  PCSTR    AddressString,
  [out] in6_addr *Address,
  [out] PULONG   ScopeId,
  [out] PUSHORT  Port
);

Parameter-parameternya

[in] AddressString

Penunjuk ke buffer yang berisi representasi string yang dihentikan NULL dari alamat IPv6, ID cakupan, dan nomor port.

[out] Address

Pointer tempat representasi biner alamat IPv6 akan disimpan.

[out] ScopeId

Pointer ke tempat ID cakupan alamat IPv6 disimpan. Jika parameter AddressString tidak berisi representasi string DARI ID cakupan, maka nol dikembalikan dalam parameter ini.

[out] Port

Penunjuk tempat nomor port disimpan. Nomor port dalam format urutan byte jaringan. Jika parameter AddressString tidak berisi representasi string dari nomor port, maka nol dikembalikan dalam parameter ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah salah satu kode kesalahan berikut.

Mengembalikan kode	Description
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika string yang ditunjukkan oleh parameter AddressString tidak berisi representasi string yang tepat dari alamat IPv6. Kode kesalahan ini didefinisikan dalam file header Ntstatus.h.
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi RtlIpv6StringToAddressEx digunakan untuk mengonversi representasi string alamat IPv6, ID cakupan, dan nomor port ke alamat IPv6 biner, ID cakupan, dan nomor port. Alamat IPv6 dikembalikan dalam urutan jaringan (byte diurutkan dari kiri ke kanan). Nomor port dan ID cakupan dikembalikan dalam urutan jaringan.

RtlIpv6StringToAddressEx adalah fungsi kenyamanan yang tidak mengharuskan Dll Soket Windows dimuat untuk mengakses fungsi yang disediakan di Soket Windows untuk melakukan string ke konversi alamat IP.

String yang ditunjukkan oleh parameter AddressString harus diwakili dalam formulir untuk string alamat IPv6 diikuti oleh karakter persen opsional dan string ID cakupan. Alamat IPv6 dan string ID cakupan harus diapit dalam tanda kurung siku. Kurung siku kanan setelah alamat IPv6 dan string ID cakupan dapat diikuti oleh titik dua opsional dan representasi string dari nomor port. Representasi string dasar alamat IPv6 terdiri dari 8 angka heksadesimal yang dipisahkan oleh titik dua. String angka nol berturut-turut dapat diganti dengan titik dua. Hanya boleh ada satu titik dua dalam representasi string alamat IPv6. 32 bit terakhir dapat diwakili dalam notasi titik-oktet gaya IPv4 jika alamat tersebut adalah alamat yang kompatibel dengan IPv4, alamat IPv4 yang dipetakan IPv6, atau alamat ISATAP. Untuk informasi selengkapnya, lihat bagian 5 RFC 5942 yang diterbitkan oleh IETF.

Ketika UNICODE atau _UNICODE ditentukan, RtlIpv6StringToAddressEx didefinisikan ke RtlIpv6StringToAddressExW, versi Unicode dari fungsi ini. Parameter AddressString didefinisikan ke jenis data PCWSTR.

Ketika UNICODE dan _UNICODE tidak ditentukan, RtlIpv6StringToAddressEx didefinisikan ke RtlIpv6StringToAddressExA, versi ANSI dari fungsi ini. Parameter AddressString didefinisikan ke jenis data PCSTR.

Struktur IN6_ADDR didefinisikan dalam file header In6addr.h.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	ip2string.h (termasuk Mstcpip.h)
Library	ntdll.lib
DLL	Ntdll.dll

Lihat juga

GetModuleHandle
GetProcAddress
IN6_ADDR
InetNtop
InetPton
LoadLibrary
RtlIpv4AddressToString
RtlIpv4AddressToStringEx
RtlIpv4StringToAddress
RtlIpv4StringToAddressEx
RtlIpv6AddressToString
RtlIpv6AddressToStringEx
RtlIpv6StringToAddress
inet_addr
inet_ntoa