Fungsi CancelMibChangeNotify2 (netioapi.h)

Artikel
08/25/2023

Fungsi CancelMibChangeNotify2 membatalkan pendaftaran pemberitahuan perubahan untuk perubahan antarmuka IP, perubahan alamat IP, perubahan rute IP, perubahan port Teredo, dan ketika tabel alamat IP unicast stabil dan dapat diambil.

Sintaks

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

Parameter

[in] NotificationHandle

Handel dikembalikan dari pendaftaran pemberitahuan atau fungsi pengambilan untuk menunjukkan pemberitahuan mana yang akan dibatalkan.

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
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter NotificationHandle adalah penunjuk NULL .
Lainnya	Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi CancelMibChangeNotify2 ditentukan pada Windows Vista dan yang lebih baru.

The
Fungsi CancelMibChangeNotify2 membatalkan pendaftaran untuk pemberitahuan perubahan yang sebelumnya diminta untuk perubahan antarmuka IP, perubahan alamat IP, perubahan rute IP, atau perubahan port Teredo pada komputer lokal. Permintaan ini dibuat dengan memanggil NotifyIpInterfaceChange, NotifyUnicastIpAddressChange, NotifyRouteChange2, atau NotifyTeredoPortChange. The
Fungsi CancelMibChangeNotify2 juga membatalkan permintaan sebelumnya untuk diberi tahu ketika tabel alamat IP unicast stabil di komputer lokal dan dapat diambil. Permintaan ini dibuat dengan memanggil fungsi NotifyStableUnicastIpAddressTable .

Parameter NotificationHandle yang dikembalikan ke fungsi pemberitahuan ini diteruskan ke CancelMibChangeNotify2 untuk membatalkan pendaftaran pemberitahuan atau membatalkan permintaan yang tertunda untuk mengambil tabel alamat IP unicast yang stabil.

Aplikasi tidak dapat melakukan panggilan ke fungsi CancelMibChangeNotify2 dari konteks utas yang saat ini menjalankan fungsi panggilan balik pemberitahuan untuk parameter NotificationHandle yang sama. Jika tidak, utas yang menjalankan panggilan balik tersebut akan mengakibatkan kebuntuan. Jadi fungsi CancelMibChangeNotify2 tidak boleh dipanggil langsung sebagai bagian dari rutinitas panggilan balik pemberitahuan. Dalam situasi yang lebih umum, utas yang menjalankan fungsi CancelMibChangeNotify2 tidak dapat memiliki sumber daya tempat utas yang menjalankan operasi panggilan balik pemberitahuan akan menunggu karena akan mengakibatkan kebuntuan serupa. Fungsi CancelMibChangeNotify2 harus dipanggil dari utas yang berbeda, tempat utas yang menerima panggilan balik pemberitahuan tidak memiliki dependensi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll