Fungsi GetAnycastIpAddressEntry
Fungsi GetAnycastIpAddressEntry mengambil informasi untuk entri alamat IP anycast yang ada di komputer lokal.
Sintaks
NETIOAPI_API GetAnycastIpAddressEntry(
_Inout_ PMIB_ANYCASTIPADDRESS_ROW Row
);
Parameter
- Baris [masuk, keluar]
Penunjuk ke entri struktur MIB_ANYCASTIPADDRESS_ROW untuk entri alamat IP anycast. Pada pengembalian yang berhasil, struktur ini diperbarui dengan properti untuk alamat IP anycast yang ada.
Mengembalikan nilai
GetAnycastIpAddressEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, GetAnycastIpAddressEntry mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika penunjuk NULL diteruskan dalam parameter Baris , anggota Alamat dari struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjuk parameter Baris tidak diatur ke alamat IPv4 atau IPv6 anycast yang valid, atau anggota InterfaceLuid dan InterfaceIndex dari struktur MIB_ANYCASTIPADDRESS_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 anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjuk 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 di anggota Alamat struktur MIB_UNICASTIPADDRESS_ROW yang ditunjuk parameter Baris , atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan di anggota Alamat . |
Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi GetAnycastIpAddressEntry digunakan untuk mengambil entri struktur MIB_ANYCASTIPADDRESS_ROW yang ada.
Pada input, driver Anda harus menginisialisasi anggota struktur MIB_ANYCASTIPADDRESS_ROW berikut yang ditunjuk oleh parameter Baris .
Alamat
Atur ke alamat dan keluarga anycast IPv4 atau IPv6 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, GetAnycastIpAddressEntry mengambil properti lain untuk alamat IP anycast dan mengisi struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjukkan parameter Baris .
Driver Anda dapat memanggil fungsi GetAnycastIpAddressTable untuk menghitung entri alamat IP anycast di komputer lokal.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Pustaka |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |