Fungsi InitializeUnicastIpAddressEntry (netioapi.h)

Artikel
03/15/2023

Fungsi InitializeUnicastIpAddressEntry menginisialisasi struktur MIB_UNICASTIPADDRESS_ROW dengan nilai default untuk entri alamat IP unicast di komputer lokal.

Sintaks

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Parameter

[out] Row

Pada entri, penunjuk ke entri struktur MIB_UNICASTIPADDRESS_ROW untuk entri alamat IP unicast. Saat dikembalikan, struktur MIB_UNICASTIPADDRESS_ROW yang ditujukan oleh parameter ini diinisialisasi dengan nilai default untuk alamat IP unicast.

Nilai kembali

Fungsi ini tidak mengembalikan nilai.

Keterangan

Fungsi InitializeUnicastIpAddressEntry didefinisikan pada Windows Vista dan yang lebih baru.

Fungsi InitializeUnicastIpAddressEntry harus digunakan untuk menginisialisasi anggota entri struktur MIB_UNICASTIPADDRESS_ROW dengan nilai default untuk alamat IP unicast untuk digunakan nanti dengan fungsi CreateUnicastIpAddressEntry .

Pada input, InitializeUnicastIpAddressEntry harus melewati struktur MIB_UNICASTIPADDRESS_ROW baru untuk diinisialisasi.

Pada output, anggota PrefixOrigin dari struktur MIB_UNICASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris akan diinisialisasi ke IpPrefixOriginUnchanged, anggota SuffixOrigin akan diinisialisasi ke IpSuffixOriginUnchanged, dan anggota OnLinkPrefixLength akan diinisialisasi ke nilai ilegal. Selain itu, anggota PreferredLifetime dan ValidLifetime diatur ke tak terbatas, anggota SkipAsSource diatur ke FALSE, dan bidang lain diinisialisasi ke nol.

Setelah memanggil InitializeUnicastIpAddressEntry, aplikasi kemudian dapat mengubah anggota dalam entri MIB_UNICASTIPADDRESS_ROW yang ingin dimodifikasi, lalu memanggil CreateUnicastIpAddressEntry untuk menambahkan alamat IP unicast baru ke komputer lokal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll