NotifyNetworkConnectivityHintChange 函式 (netioapi.h)

註冊應用程式定義的回呼函式，在匯總網路連線層級和成本提示變更時呼叫。

語法

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API NotifyNetworkConnectivityHintChange(
  [in]  PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK Callback,
  [in]  PVOID                                      CallerContext,
  [in]  BOOLEAN                                    InitialNotification,
  [out] PHANDLE                                    NotificationHandle
);

參數

[in] Callback

類型為 PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK 的函式指標，指向應用程式定義的回呼函式。 當網路連線層級或成本變更發生時，將會叫用回呼函式。

[in] CallerContext

使用者特定的呼叫端內容。 此內容將會提供給回呼函式。

[in] InitialNotification

True 如果應該提供初始化通知，則為 ，否則 false為 。

[out] NotificationHandle

HANDLE 的指標。 函式會將 值設定為通知註冊的句柄。

傳回值

如果函式成功，傳回值會 NO_ERROR。 否則會傳回錯誤碼。

備註

若要取消註冊變更通知，請呼叫 CancelMibChangeNotify2 函式，傳遞 NotifyNetworkConnectivityHintChange 傳回的 NotificationHandle 參數。

規格需求

另請參閱

• PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK

• CancelMibChangeNotify2