Condividi tramite

Funzione NotifyNetworkConnectivityHintChange (netioapi.h)

  • Articolo

Registra una funzione di callback definita dall'applicazione, da chiamare quando il livello di connettività di rete aggrega e gli hint sui costi cambiano.

Sintassi

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

Parametri

[in] Callback

Puntatore di funzione di tipo PNETWORK_CONNECTIVITY_HINT_CHANGE_CALLBACK, che punta alla funzione di callback definita dall'applicazione. La funzione di callback verrà richiamata quando si verifica una modifica del livello di connettività di rete o del costo.

[in] CallerContext

Contesto del chiamante specifico dell'utente. Questo contesto verrà fornito alla funzione di callback.

[in] InitialNotification

True se deve essere fornita una notifica di inizializzazione, in caso contrario false.

[out] NotificationHandle

Puntatore a un HANDLE. La funzione imposta il valore su un handle per la registrazione della notifica.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR. In caso contrario, viene restituito un codice di errore.

Commenti

Per annullare la registrazione delle notifiche delle modifiche, chiamare la funzione CancelMibChangeNotify2 passando il parametro NotificationHandle restituito da NotifyNetworkConnectivityHintChange.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 2004 (10.0; Build 19041)
Server minimo supportato Windows Server, versione 2004 (10.0; Build 19041)
Piattaforma di destinazione Windows
Intestazione netioapi.h (includere Iphlpapi.h)
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche