Fungsi RtlIpv6AddressToStringA (ip2string.h)

Artikel
03/14/2023

Fungsi RtlIpv6AddressToString mengonversi alamat IPv6 menjadi string dalam format standar Internet.

Sintaks

NTSYSAPI PSTR RtlIpv6AddressToStringA(
  [in]  const in6_addr *Addr,
  [out] PSTR           S
);

Parameter

[in] Addr

Alamat IPv6 dalam urutan byte jaringan.

[out] S

Penunjuk ke buffer untuk menyimpan representasi string yang dihentikan NULL dari alamat IPv6. Buffer ini harus cukup besar untuk menampung setidaknya 46 karakter.

Mengembalikan nilai

Penunjuk ke karakter NULL yang dimasukkan di akhir representasi string alamat IPv6. Ini dapat digunakan oleh pemanggil untuk dengan mudah menambahkan informasi lebih lanjut ke string.

Keterangan

Fungsi RtlIpv6AddressToString digunakan untuk mengonversi alamat IPv6 ke representasi string alamat IPv6 dalam format standar Internet.

Representasi string dasar terdiri dari 8 angka heksadesimal yang dipisahkan oleh titik dua. String angka nol berturut-turut diganti dengan titik dua. Hanya ada satu titik dua dalam representasi string alamat IPv6. 32 bit terakhir diwakili dalam notasi titik-oktet gaya IPv4 jika alamat tersebut 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.

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

Ketika UNICODE atau _UNICODE ditentukan, RtlIpv6AddressToString didefinisikan ke RtlIpv6AddressToStringW, versi Unicode dari fungsi ini. Parameter string S dan nilai pengembalian fungsi ditentukan ke jenis data PWSTR.

Ketika UNICODE dan _UNICODE tidak ditentukan, RtlIpv6AddressToString didefinisikan ke RtlIpv6AddressToStringA, versi ANSI dari fungsi ini. Parameter string S dan nilai pengembalian fungsi ditentukan ke jenis data PSTR.

Struktur IN6_ADDR ditentukan dalam file header In6addr.h .

Pustaka impor yang berisi fungsi RtlIpv6AddressToString tidak disertakan dalam Microsoft Windows Software Development Kit (SDK) yang dirilis untuk Windows Vista. Fungsi RtlIpv6AddressToString 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.

Catatan

Header ip2string.h mendefinisikan RtlIpv6AddressToString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


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, Ip2string.h)
Pustaka	ntdll.lib
DLL	ntdll.dll