CancelMibChangeNotify2 函式 (netioapi.h)

發行項
02/29/2024

CancelMibChangeNotify2 函式會取消註冊 IP 介面變更、IP 位址變更、IP 路由變更、Teredo 埠變更，以及單播 IP 位址數據表穩定且可擷取的變更通知。

語法

IPHLPAPI_DLL_LINKAGE NETIOAPI_API CancelMibChangeNotify2(
  [in] HANDLE NotificationHandle
);

參數

[in] NotificationHandle

從通知註冊或擷取函式傳回的句柄，表示要取消的通知。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

傳回碼	Description
ERROR_INVALID_PARAMETER	無效的參數已傳遞至函式。如果 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