NotifyNetworkConnectivityHintChange-Funktion (netioapi.h)

Artikel
08/25/2023

Registriert eine anwendungsdefinierte Rückruffunktion, die aufgerufen wird, wenn sich die aggregierte Netzwerkkonnektivitätsebene und die Kostenhinweise ändern.

Syntax

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

Parameter

[in] Callback

Ein Funktionszeiger vom Typ PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, der auf Ihre anwendungsdefinierte Rückruffunktion verweist. Die Rückruffunktion wird aufgerufen, wenn eine Netzwerkkonnektivitätsebene oder Kostenänderung auftritt.

[in] CallerContext

Der benutzerspezifische Aufruferkontext. Dieser Kontext wird für die Rückruffunktion bereitgestellt.

[in] InitialNotification

True , wenn eine Initialisierungsbenachrichtigung bereitgestellt werden soll, andernfalls false.

[out] NotificationHandle

Ein Zeiger auf einen HANDLE. Die Funktion legt den Wert auf ein Handle für die Benachrichtigungsregistrierung fest.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR. Andernfalls wird ein Fehlercode zurückgegeben.

Hinweise

Um die Registrierung für Änderungsbenachrichtigungen aufzuheben, rufen Sie die Funktion CancelMibChangeNotify2 auf, und übergeben Sie den von NotifyNetworkConnectivityHintChange zurückgegebenenNotificationHandle-Parameter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server)	Windows Server, Version 2004 (10.0; Build 19041)
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Share via