Metodo IMbnInterfaceEvents::OnSetPreferredProvidersComplete (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 SetPreferredProviders .

Sintassi

HRESULT OnSetPreferredProvidersComplete(
  [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 operazione asincrona.

[in] status

Stato di completamento dell'operazione.

Nella tabella seguente sono elencati i valori validi per questo stato.

Valore	Significato
S_OK	L'operazione è stata completata.
E_MBN_PIN_REQUIRED	Il dispositivo richiede l'immissione di un PIN per il completamento dell'operazione.
E_MBN_SIM_NOT_INSERTED	La SIM non viene inserita.
E_MBN_BAD_SIM	Nel dispositivo viene inserita una SIM non valida.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il dispositivo non supporta questa operazione.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Se l'operazione è stata completata correttamente, ovvero quando lo stato è S_OK, l'applicazione può chiamare il metodo GetPreferredProviders del metodo IMbnInterface passato per ottenere un elenco aggiornato di provider preferiti.

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à anche una notifica.

Se una chiamata al metodo SetPreferredProviders di IMbnInterface comporta una modifica nell'elenco dei provider preferito, il metodo OnPreferredProvidersChange di IMbnInterfaceEvents non verrà chiamato.

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