Fungsi GetUnicastIpAddressEntry

Fungsi GetUnicastIpAddressEntry mengambil informasi untuk entri alamat IP unicast yang ada di komputer lokal.

Sintaksis

NETIOAPI_API GetUnicastIpAddressEntry(
  _Inout_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parameter

• Baris [masuk, keluar]
  Penunjuk ke entri struktur MIB_UNICASTIPADDRESS_ROW untuk entri alamat IP unicast. Pada pengembalian yang berhasil, struktur ini diperbarui dengan properti untuk alamat IP unicast yang ada.

Mengembalikan nilai

GetUnicastIpAddressEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, GetUnicastIpAddressEntry mengembalikan salah satu kode kesalahan berikut:

Mengembalikan kode	Deskripsi
STATUS_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris, Alamat anggota struktur MIB_UNICASTIPADDRESS_ROW yang ditunjukkan parameter Baris tidak diatur ke alamat IPv4 atau IPv6 unicast yang valid, atau InterfaceLuid dan InterfaceIndex anggota struktur MIB_UNICASTIPADDRESS_ROW tidak ditentukan.
STATUS_NOT_FOUND	Antarmuka yang ditentukan tidak dapat ditemukan. Kesalahan ini dikembalikan jika fungsi tidak dapat menemukan antarmuka jaringan yang ditentukan oleh InterfaceLuid atau InterfaceIndex anggota struktur MIB_UNICASTIPADDRESS_ROW yang ditunjuk oleh parameter Baris.
STATUS_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 yang terletak di komputer lokal dan alamat IPv4 ditentukan dalam alamat anggota struktur MIB_UNICASTIPADDRESS_ROW yang ditunjuk parameter Baris, atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan dalam alamat anggota.
Lainnya	Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Komentar

Fungsi GetUnicastIpAddressEntry biasanya digunakan untuk mengambil entri struktur MIB_UNICASTIPADDRESS_ROW yang ada untuk dimodifikasi. Driver kemudian dapat mengubah anggota dalam entri MIB_UNICASTIPADDRESS_ROW yang ingin dimodifikasi, lalu memanggil fungsiSetUnicastIpAddressEntry.

Pada input, driver Anda harus menginisialisasi anggota struktur MIB_UNICASTIPADDRESS_ROW berikut yang ditunjuk oleh parameter Baris.

• Alamat
  Atur ke alamat dan keluarga IPv4 atau IPv6 unicast yang valid.

• InterfaceLuid atau InterfaceIndex
  Anggota ini digunakan dalam urutan yang tercantum sebelumnya. Jadi jika InterfaceLuid ditentukan, anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.

Pada output, ketika panggilan berhasil, GetUnicastIpAddressEntry mengambil properti lain untuk alamat IP unicast dan mengisi struktur MIB_UNICASTIPADDRESS_ROW yang ditunjuk oleh parameter Baris.

Driver Anda dapat memanggil fungsiGetUnicastIpAddressTable untuk menghitung entri alamat IP unicast di komputer lokal.

Persyaratan

Platform target	Universal
Versi	Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Header	Netioapi.h (termasuk Netioapi.h)
Perpustakaan	Netio.lib
IRQL	< DISPATCH_LEVEL

Lihat juga

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry