Metodo IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)
Importante
A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.
Questo metodo di notifica viene chiamato dal servizio Mobile Broadband per indicare il completamento di un'analisi di rete.
Sintassi
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parametri
[in] newInterface
IMbnInterface che rappresenta un dispositivo in cui è stata eseguita questa operazione.
[in] requestID
ID richiesta assegnato dal servizio Mobile Broadband per questa notifica.
[in] status
Stato di completamento dell'operazione
Un'applicazione chiamante può prevedere uno dei valori seguenti.
S_OK
L'operazione è stata completata.
E_MBN_RADIO_POWER_OFF
Non è possibile ottenere un elenco di rete visibile perché la radio del dispositivo è disattivata. L'applicazione può inviare una richiesta di analisi di rete quando riceve la notifica attivata tramite radio.
E_MBN_DEVICE_BUSY
Il dispositivo è occupato e non può attualmente eseguire un'operazione di analisi di rete. Questa operazione viene restituita dai dispositivi che non supportano un'operazione di analisi di rete quando è stabilita una connessione dati.
E_MBN_ALREADY_ACTIVE
Un'operazione di analisi di rete è già in corso.
Valore restituito
Questo metodo deve restituire S_OK.
Commenti
Se l'operazione è stata completata correttamente, ovvero quando lo stato è S_OK, il servizio Mobile Broadband ha aggiornato correttamente l'elenco memorizzato nella cache dei provider visibili. Un'applicazione può quindi chiamare il metodo GetVisibleProvidersdell'interfaccia IMbnInterface passata per ottenere l'elenco dei provider visibili.
Se più applicazioni registrate per le notifiche, questo metodo verrà chiamato in tutte le applicazioni registrate. Ciò significa che un'applicazione che non ha avviato l'operazione di aggiornamento riceverà una notifica.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |