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 GetAnycastIpAddressEntry mengambil informasi untuk entri alamat IP anycast yang ada di komputer lokal.
Sintaks
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetAnycastIpAddressEntry(
[in, out] PMIB_ANYCASTIPADDRESS_ROW Row
);
Parameter
[in, out] Row
Penunjuk ke entri struktur MIB_ANYCASTIPADDRESS_ROW untuk entri alamat IP anycast. Pada pengembalian yang berhasil, struktur ini akan diperbarui dengan properti untuk alamat IP anycast yang ada.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Sistem tidak dapat menemukan file yang ditentukan. Kesalahan ini dikembalikan jika antarmuka jaringan LUID atau indeks antarmuka yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndexdari MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris bukan nilai pada komputer lokal. |
|
Parameter salah. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris , anggota AlamatMIB_ANYCASTIPADDRESS_ROW yang diarahkan oleh parameter Baris tidak diatur ke alamat IPv4 atau IPv6 anycast yang valid, atau anggota InterfaceLuid atau InterfaceIndexdari MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris tidak ditentukan. |
|
Elemen tidak ditemukan. Kesalahan ini dikembalikan jika antarmuka jaringan yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris tidak cocok dengan alamat IP dan keluarga alamat yang ditentukan dalam anggota Alamat dalam struktur MIB_ANYCASTIPADDRESS_ROW . |
|
Permintaan tidak didukung. Kesalahan ini dikembalikan jika tidak ada tumpukan IPv4 di komputer lokal dan alamat IPv4 ditentukan dalam anggota Alamat struktur MIB_UNICASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris . Kesalahan ini dikembalikan jika tidak ada tumpukan IPv6 di komputer lokal dan alamat IPv6 ditentukan dalam anggota Alamat . |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi GetAnycastIpAddressEntry ditentukan pada Windows Vista dan yang lebih baru.
Fungsi GetAnycastIpAddressEntry digunakan untuk mengambil entri struktur MIB_ANYCASTIPADDRESS_ROW yang ada.
Pada input, anggota Alamat dalam struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris harus diinisialisasi ke alamat dan keluarga IPv4 atau IPv6 anycast yang valid. Selain itu, setidaknya salah satu anggota berikut dalam struktur MIB_ANYCASTIPADDRESS_ROW yang menunjuk ke parameter Baris harus diinisialisasi: InterfaceLuid atau InterfaceIndex.
Bidang digunakan dalam urutan yang tercantum di atas. Jadi, jika InterfaceLuid ditentukan, maka anggota ini digunakan untuk menentukan antarmuka. Jika tidak ada nilai yang diatur untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), maka anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Pada output saat panggilan berhasil, GetAnycastIpAddressEntry mengambil properti lain untuk alamat IP anycast dan mengisi struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan oleh parameter Baris .
Fungsi GetAnycastIpAddressTable dapat dipanggil untuk menghitung entri alamat IP anycast di 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 |