Partager via

Fonction NotifyNetworkConnectivityHintChange (netioapi.h)

  • Article

Inscrit une fonction de rappel définie par l’application, à appeler lorsque le niveau de connectivité réseau agrégé et les indicateurs de coût changent.

Syntaxe

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

Paramètres

[in] Callback

Pointeur de fonction de type PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, qui pointe vers votre fonction de rappel définie par l’application. La fonction de rappel est appelée lorsqu’un changement de niveau de connectivité réseau ou de coût se produit.

[in] CallerContext

Contexte de l’appelant spécifique à l’utilisateur. Ce contexte sera fourni à la fonction de rappel.

[in] InitialNotification

True si une notification d’initialisation doit être fournie, sinon false.

[out] NotificationHandle

Pointeur vers un HANDLE. La fonction définit la valeur sur un handle pour l’inscription de notification.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR. Sinon, un code d’erreur est retourné.

Remarques

Pour annuler l’inscription pour les notifications de modification, appelez la fonction CancelMibChangeNotify2 , en passant le paramètre NotificationHandle retourné par NotifyNetworkConnectivityHintChange.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004 (10.0 ; Build 19041)
Serveur minimal pris en charge Windows Server, version 2004 (10.0 ; Build 19041)
Plateforme cible Windows
En-tête netioapi.h (inclure Iphlpapi.h)
Bibliothèque Iphlpapi.lib
DLL Iphlpapi.dll

Voir aussi