Fungsi NotifyIpInterfaceChange
Fungsi NotifyIpInterfaceChange mendaftarkan driver untuk diberi tahu tentang perubahan pada semua antarmuka IP, antarmuka IPv4, atau antarmuka IPv6 di komputer lokal.
Sintaks
NETIOAPI_API NotifyIpInterfaceChange(
_In_ ADDRESS_FAMILY Family,
_In_ PIPINTERFACE_CHANGE_CALLBACK Callback,
_In_ PVOID CallerContext,
_In_ BOOLEAN InitialNotification,
_Inout_ HANDLE *NotificationHandle
);
Parameter
Keluarga [in]
Keluarga alamat untuk mendaftarkan driver untuk pemberitahuan perubahan.Nilai yang mungkin untuk keluarga alamat tercantum dalam file header Winsock2.h. Perhatikan bahwa nilai untuk keluarga alamat AF_ dan konstanta keluarga protokol PF_ identik (misalnya, AF_INET dan PF_INET), sehingga Anda dapat menggunakan salah satu konstanta.
Pada Windows Vista dan versi yang lebih baru dari sistem operasi Windows, nilai yang mungkin untuk parameter Family didefinisikan dalam file header Ws2def.h. Perhatikan bahwa file header Ws2def.h secara otomatis disertakan dalam Netioapi.h dan Anda tidak boleh menggunakan Ws2def.h secara langsung.
Nilai berikut saat ini didukung untuk keluarga alamat:
AF_INET
Keluarga alamat IPv4. Ketika nilai ini ditentukan, fungsi ini mendaftarkan driver yang akan diberi tahu hanya untuk pemberitahuan perubahan IPv4.AF_INET6
Keluarga alamat IPv6. Ketika nilai ini ditentukan, fungsi ini mendaftarkan driver hanya untuk pemberitahuan perubahan IPv6.AF_UNSPEC
Keluarga alamat tidak ditentukan. Ketika nilai ini ditentukan, fungsi ini mendaftarkan driver yang akan diberi tahu untuk perubahan IPv4 dan IPv6.
Panggilan balik [in]
Penunjuk ke fungsi untuk memanggil saat perubahan terjadi. Fungsi ini dipanggil ketika pemberitahuan antarmuka diterima.CallerContext [in]
Konteks pengguna yang diteruskan ke fungsi panggilan balik yang ditentukan dalam parameter Panggilan Balik saat pemberitahuan antarmuka diterima.InitialNotification [in]
Nilai yang menunjukkan apakah panggilan balik harus dipanggil segera setelah pendaftaran untuk pemberitahuan perubahan selesai. Pemberitahuan awal ini tidak menunjukkan perubahan yang terjadi pada antarmuka IP. Tujuan parameter ini untuk memberikan konfirmasi bahwa panggilan balik terdaftar.NotificationHandle [masuk, keluar]
Pointer yang digunakan untuk mengembalikan handel yang nantinya dapat digunakan untuk membatalkan pendaftaran pemberitahuan perubahan. Jika berhasil, handel pemberitahuan dikembalikan dalam parameter ini. Jika terjadi kesalahan, NULL dikembalikan.
Nilai kembali
NotifyIpInterfaceChange mengembalikan STATUS_SUCCESS jika fungsi berhasil.
Jika fungsi gagal, NotifyIpInterfaceChange mengembalikan salah satu kode kesalahan berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| ERROR_INVALID_HANDLE | Terjadi kesalahan internal di mana handel tidak valid ditemukan. |
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter Family tidak AF_INET, AF_INET6, atau AF_UNSPEC. |
| STATUS_NOT_ENOUGH_MEMORY | Memori tidak cukup. |
| Lainnya | Gunakan fungsi FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Driver Anda harus mengatur parameter Family ke AF_INET, AF_INET6, atau AF_UNSPEC.
Pemanggilan fungsi panggilan balik yang ditentukan dalam parameter Panggilan Balik diserialisasikan. Fungsi panggilan balik harus didefinisikan sebagai fungsi jenis VOID. Parameter yang diteruskan ke fungsi panggilan balik mencakup yang berikut ini.
| Parameter | Deskripsi |
|---|---|
DALAM PVOID CallerContext |
Parameter CallerContext yang diteruskan ke fungsi NotifyIpInterfaceChange saat mendaftarkan driver untuk pemberitahuan perubahan. |
DI Baris PMIB_IPINTERFACE_ROW OPSIONAL |
Penunjuk ke entri MIB_IPINTERFACE_ROW untuk antarmuka yang diubah. Parameter ini adalah penunjuk NULL ketika nilai MIB_NOTIFICATION_TYPE yang diteruskan dalam parameter NotificationType ke fungsi panggilan balik diatur ke MibInitialNotification. Situasi ini hanya dapat terjadi jika parameter InitialNotification yang diteruskan ke NotifyIpInterfaceChange diatur ke TRUE saat mendaftarkan driver untuk pemberitahuan perubahan. |
IN MIB_NOTIFICATION_TYPE NotificationType |
Jenis pemberitahuan. Anggota ini bisa menjadi salah satu nilai dari jenis enumerasi MIB_NOTIFICATION_TYPE . |
Untuk membatalkan pendaftaran driver untuk pemberitahuan perubahan, panggil fungsi CancelMibChangeNotify2 , melewati parameter NotificationHandle yang dikembalikan NotifyIpInterfaceChange .
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 |