Fungsi RtlIpv6StringToAddressExW (ip2string.h)

Artikel
08/24/2023

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

Sintaks

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

Parameter

[in] AddressString

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

[out] Address

Penunjuk 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.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.

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

Menampilkan kode	Deskripsi
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.

Keterangan

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 Windows Sockets DLL 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 dengan 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 ada satu titik dua dalam representasi string alamat IPv6. 32 bit terakhir dapat diwakili dalam notasi titik-oktet gaya IPv4 jika alamatnya adalah alamat yang kompatibel dengan IPv4, alamat IPv6 yang dipetakan IPv4, 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 ditentukan dalam file header In6addr.h.

Pustaka impor yang berisi fungsi RtlIpv6StringToAddressEx tidak disertakan dalam Microsoft Windows Software Development Kit (SDK) yang dirilis untuk Windows Vista. Fungsi RtlIpv6StringToAddressEx disertakan dalam pustaka impor Ntdll.lib yang disertakan dalam Windows Driver Kit (WDK). Aplikasi juga dapat menggunakan fungsi GetModuleHandle dan GetProcAddress untuk mengambil penunjuk fungsi dari Ntdll.dll dan memanggil fungsi ini.

Persyaratan

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