CancelMibChangeNotify2 函式
CancelMibChangeNotify2函式會取消註冊驅動程式變更通知,以瞭解 IP 介面變更、IP 位址變更、IP 路由變更,以及擷取穩定單播 IP 位址表的要求。
語法
NETIOAPI_API CancelMibChangeNotify2(
_In_ HANDLE NotificationHandle
);
參數
- NotificationHandle [in]
從通知註冊或擷取函式傳回的控制碼,表示要取消的通知。
傳回值
如果函式成功,CancelMibChangeNotify2會傳回STATUS_SUCCESS。
如果函式失敗, CancelMibChangeNotify2 會傳回下列其中一個錯誤碼:
傳回碼 | 描述 |
---|---|
STATUS_INVALID_PARAMETER | 不正確參數已傳遞至 函式。 如果NotificationHandle參數是Null指標,CancelMibChangeNotify2會傳回此錯誤。 |
其他 | 使用 FormatMessage 函式來取得傳回錯誤的訊息字串。 |
備註
CancelMibChangeNotify2函式會取消註冊先前要求 IP 介面變更、IP 位址變更或本機電腦上的 IP 路由變更的驅動程式變更通知。 這些要求是藉由呼叫 NotifyIpInterfaceChange、 NotifyRouteChange2或 NotifyUnicastIpAddressChange來進行。 CancelMibChangeNotify2函式也會取消先前的要求,以擷取本機電腦上的穩定單播 IP 位址資料表。 呼叫 NotifyStableUnicastIpAddressTable 函式即可提出此要求。
傳回給這些通知函式的 NotificationHandle 參數會傳遞至 CancelMibChangeNotify2 以取消註冊驅動程式變更通知,或解除擱置要求以擷取穩定單播 IP 位址表。
規格需求
目標平台 |
普遍 |
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Netioapi.h (包含 Netioapi.h) |
程式庫 |
Netio.lib |
IRQL |
PASSIVE_LEVEL |