Fungsi RtlIpv4StringToAddressExA (ip2string.h)

Fungsi RtlIpv4StringToAddressEx mengonversi representasi string alamat IPv4 dan nomor port ke alamat dan port IPv4 biner.

Syntax

NTSYSAPI NTSTATUS RtlIpv4StringToAddressExA(
  [in]  PCSTR   AddressString,
  [in]  BOOLEAN Strict,
  [out] in_addr *Address,
  [out] PUSHORT Port
);

Parameter-parameternya

[in] AddressString

Penunjuk ke buffer yang berisi representasi string yang dihentikan NULL dari alamat IPv4 diikuti oleh titik dua opsional dan representasi string dari nomor port.

[in] Strict

Nilai yang menunjukkan apakah string harus berupa alamat IPv4 yang diwakili dalam notasi desimal bertitik empat bagian yang ketat. Jika parameter ini TRUE, string harus bertitik-desimal dengan empat bagian. Jika parameter ini FALSE, salah satu dari empat formulir diizinkan untuk representasi string alamat Ipv4, dengan notasi desimal, oktal, atau heksadesimal. Lihat bagian Keterangan untuk detailnya.

[out] Address

Pointer tempat representasi biner alamat IPv4 akan disimpan. Alamat IPv4 disimpan dalam urutan byte jaringan.

[out] Port

Pointer tempat representasi biner dari nomor port akan disimpan. Nomor port dikembalikan dalam urutan byte jaringan. Jika tidak ada port yang ditentukan dalam string yang diacu oleh parameter AddressString , maka parameter Port diatur ke nol.

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 parameter Strict diatur ke TRUE, tetapi string yang ditunjukkan oleh parameter AddressString tidak berisi representasi string desimal putus-putus empat bagian dari alamat IPv4. Kesalahan ini juga dikembalikan jika string yang ditunjukkan oleh parameter AddressString tidak berisi representasi string yang tepat dari alamat IPv4. Kode kesalahan ini didefinisikan dalam file header Ntstatus.h.

Komentar

Fungsi RtlIpv4StringToAddressEx digunakan untuk mengonversi representasi string alamat IPv4 dan nomor port ke alamat IPv4 biner dan nomor port. Alamat IPv4 dikembalikan dalam urutan jaringan (byte diurutkan dari kiri ke kanan). Nomor port dikembalikan dalam urutan jaringan.

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

Jika parameter Ketat diatur ke TRUE, maka string yang diarahkan oleh parameter AddressString harus dalam notasi desimal putus-putus yang ketat. Format ketat ini mengharuskan empat bagian ditentukan. Setiap bagian ditafsirkan sebagai byte desimal data dan ditetapkan, dari kiri ke kanan, ke empat byte alamat IPv4.

Ketika parameter Ketat diatur ke FALSE, string yang ditujukkan oleh parameter AddressString mungkin berada dalam salah satu dari beberapa format yang mungkin. Ketika buffer yang diacu oleh parameter AddressString berisi string alamat tiga bagian, bagian terakhir ditafsirkan sebagai kuantitas 16-bit dan ditempatkan di dua byte paling kanan dari alamat jaringan. Ini membuat format alamat tiga bagian nyaman untuk menentukan alamat jaringan Kelas B sebagai "128.net.host".

Ketika buffer yang ditujukkan oleh parameter AddressString berisi string alamat dua bagian, bagian terakhir ditafsirkan sebagai kuantitas 24-bit dan ditempatkan di paling kanan tiga byte alamat jaringan. Ini membuat format alamat dua bagian nyaman untuk menentukan alamat jaringan Kelas A sebagai "net.host". Ketika buffer yang diarahkan oleh parameter AddressString hanya berisi string alamat satu bagian, nilai disimpan langsung di alamat jaringan tanpa pengaturan ulang byte apa pun.

Buffer yang ditunjukkan oleh parameter AddressString mungkin berisi string alamat IPv4 diikuti oleh titik dua opsional dan representasi string dari nomor port. Jika string nomor port disertakan dalam buffer yang ditunjukkan oleh parameter AddressString , representasi biner dari nomor port dikembalikan dalam parameter Port . Jika buffer yang ditujukkan oleh parameter AddressString tidak berisi nomor port, nol dikembalikan dalam parameter Port .

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

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

Struktur IN_ADDR ditentukan dalam file header Inaddr.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
IN_ADDR
InetNtop
InetPton
LoadLibrary
RtlIpv4AddressToString
RtlIpv4AddressToStringEx
RtlIpv4StringToAddress
RtlIpv6AddressToString
RtlIpv6AddressToStringEx
RtlIpv6StringToAddress
RtlIpv6StringToAddressEx
inet_addr
inet_ntoa