Metodo IMbnMultiCarrierEvents::OnScanNetworkComplete (mbnapi.h)

Articolo
08/24/2023

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'operazione ScanNetwork .

Sintassi

HRESULT OnScanNetworkComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parametri

[in] mbnInterface

Oggetto IMbnMultiCarrier che rappresenta l'operazione ScanNetwork del dispositivo Mobile Broadband.

[in] requestID

ID richiesta assegnato dal servizio Mobile Broadband all'operazione ScanNetwork .

[in] status

Codice di stato che indica il risultato di ScanNetwork.

Valore	Significato
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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L'operazione non è supportata dal dispositivo. Questa operazione può essere restituita dai dispositivi che non supportano più vettori.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Se 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 GetVisibleProviders dell'oggetto IMbnMultiCarrier passato 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 8 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnMultiCarrierEvents

Condividi tramite