Fungsi RtlIpv4AddressToStringA (ip2string.h)

Artikel
01/27/2024

Fungsi RtlIpv4AddressToString mengonversi alamat IPv4 menjadi string dalam format dotted-decimal standar Internet.

Sintaks

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

Parameter

[in] Addr

Alamat IPv4 dalam urutan byte jaringan.

[out] S

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

Mengembalikan nilai

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

Keterangan

Fungsi RtlIpv4AddressToString digunakan untuk mengonversi alamat IPv4 ke representasi string alamat IPv4 dalam format desimal bertitik Internet.

RtlIpv4AddressToString 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, RtlIpv4AddressToString didefinisikan ke RtlIpv4AddressToStringW, versi Unicode dari fungsi ini. Parameter string S dan nilai pengembalian fungsi ditentukan ke jenis data PWSTR.

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

Struktur IN_ADDR ditentukan dalam file header Inaddr.h .

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