Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Fungsi RtlIpv6AddressToString mengonversi alamat IPv6 menjadi string dalam format standar Internet.
Syntax
NTSYSAPI PSTR RtlIpv6AddressToStringA(
[in] const in6_addr *Addr,
[out] PSTR S
);
Parameter-parameternya
[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.
Komentar
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 boleh ada satu titik dua dalam representasi string alamat IPv6. 32 bit terakhir diwakili dalam notasi titik-oktet gaya IPv4 jika alamatnya 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.
RtlIpv6AddressToString adalah fungsi kenyamanan yang tidak mengharuskan Dll Soket Windows 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 didefinisikan 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 didefinisikan ke jenis data PSTR.
Struktur IN6_ADDR ditentukan dalam file header In6addr.h .
Nota
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
| 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, Ip2string.h) |
| Library | ntdll.lib |
| DLL | ntdll.dll |