CancelMibChangeNotify2 函式 (netioapi.h)
CancelMibChangeNotify2 函式會取消註冊 IP 介面變更、IP 位址變更、IP 路由變更、Teredo 埠變更,以及單播 IP 位址數據表穩定且可擷取的變更通知。
語法
IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
[in] HANDLE NotificationHandle
);
參數
[in] NotificationHandle
從通知註冊或擷取函式傳回的句柄,表示要取消的通知。
傳回值
如果函式成功,傳回值會NO_ERROR。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
傳回碼 | Description |
---|---|
|
無效的參數已傳遞至 函式。 如果 NotificationHandle 參數是 NULL 指標,就會傳回此錯誤。 |
|
使用 FormatMessage 取得傳回錯誤的訊息字串。 |
備註
CancelMibChangeNotify2 函式是在 Windows Vista 和更新版本上定義。
The
CancelMibChangeNotify2 函式會取消註冊先前針對 IP 介面變更、IP 位址變更、IP 路由變更或本機電腦上的 Teredo 埠變更所要求的變更通知。 這些要求是藉由呼叫 NotifyIpInterfaceChange、 NotifyUnicastIpAddressChange、 NotifyRouteChange2 或 NotifyTeredoPortChange 來進行。 The
CancelMibChangeNotify2 函式也會取消先前的要求,以在本機電腦上的單播 IP 位址數據表穩定時收到通知,而且可以擷取。 呼叫 NotifyStableUnicastIpAddressTable 函式來提出此要求。
傳回給這些通知函式的 NotificationHandle 參數會傳遞至 CancelMibChangeNotify2 以取消註冊通知,或取消擱置要求以擷取穩定單播 IP 位址表。
應用程式無法從線程的內容呼叫 CancelMibChangeNotify2 函式,該線程目前執行相同 NotificationHandle 參數的通知回呼函式。 否則,執行該回呼的線程將會導致死結。 因此 ,CancelMibChangeNotify2 函式不得直接呼叫為通知回呼例程的一部分。 在較普遍的情況下,執行 CancelMibChangeNotify2 函式的線程無法擁有執行通知回呼作業的線程會等候的資源,因為它會產生類似的死結。 CancelMibChangeNotify2 函式應該從不同的線程呼叫,其中接收通知回呼的線程沒有相依性。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | netioapi.h (包括 Iphlpapi.h) |
程式庫 | Iphlpapi.lib |
Dll | Iphlpapi.dll |