Fungsi CreateAnycastIpAddressEntry
Fungsi CreateAnycastIpAddressEntry menambahkan entri alamat IP anycast baru di komputer lokal.
Sintaks
NETIOAPI_API CreateAnycastIpAddressEntry(
_In_ const MIB_ANYCASTIPADDRESS_ROW *Row
);
Parameter
- Baris [in]
Penunjuk ke entri struktur MIB_ANYCASTIPADDRESS_ROW untuk entri alamat IP anycast.
Mengembalikan nilai
CreateAnycastIpAddressEntry mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, CreateAnycastIpAddressEntry 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 unicast 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_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 di anggota Alamat struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjuk parameter Baris , atau jika tidak ada tumpukan IPv6 yang terletak di komputer lokal dan alamat IPv6 ditentukan di anggota Alamat . |
ERROR_OBJECT_ALREADY_EXISTS | Objek sudah ada. Kesalahan ini dikembalikan jika anggota Alamat dari struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjuk parameter Baris adalah duplikat alamat IP anycast yang ada pada antarmuka yang ditentukan oleh anggota InterfaceLuid atau InterfaceIndex dari struktur MIB_ANYCASTIPADDRESS_ROW. |
Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Driver Anda harus menginisialisasi anggota struktur MIB_ANYCASTIPADDRESS_ROW berikut yang ditunjuk 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 untuk menambahkan alamat IP unicast. Jika tidak ada nilai yang ditetapkan untuk anggota InterfaceLuid (nilai anggota ini diatur ke nol), anggota InterfaceIndex selanjutnya digunakan untuk menentukan antarmuka.
Anggota ScopeId dari struktur MIB_ANYCASTIPADDRESS_ROW yang diabaikan parameter Baris diabaikan saat fungsi CreateAnycastIpAddressEntry dipanggil. Anggota ScopeId secara otomatis ditentukan oleh antarmuka tempat alamat ditambahkan.
Fungsi CreateAnycastIpAddressEntry gagal jika alamat IP anycast yang diteruskan di anggota Alamat struktur MIB_ANYCASTIPADDRESS_ROW yang ditunjuk parameter Baris adalah duplikat dari alamat IP anycast yang ada pada antarmuka.
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk