Metodo IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)

  • Articolo

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

Vedi anche

IMbnInterfaceEvents