Metodo IMbnInterface::GetPreferredProviders (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.
Ottiene l'elenco dei provider preferiti.
Sintassi
HRESULT GetPreferredProviders(
[out, retval] SAFEARRAY **preferredProviders
);
Parametri
[out, retval] preferredProviders
Puntatore a una matrice di strutture MBN_PROVIDER che contiene l'elenco di provider preferiti. Se questo metodo restituisce qualsiasi valore diverso da S_OK, questo parametro è NULL. Quando GetPreferredProviders restituisce S_OK, l'applicazione chiamante deve liberare la memoria allocata chiamando SafeArrayDestroy.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. preferredProviders contiene valori validi. |
|
Le informazioni non sono disponibili. Il servizio Mobile Broadband sta attualmente verificando l'elenco dei provider preferiti. L'applicazione chiamante può ricevere una notifica quando i dati sono disponibili registrando per il metodo OnPreferredProvidersChange di IMbnInterfaceEvents. |
|
Il dispositivo richiede che sia necessario immettere un PIN per questa operazione. |
|
La SIM non viene inserita. |
|
Una SIM non valida viene inserita nel dispositivo. |
|
Impossibile leggere dalla sim o dalla memoria del dispositivo. Ad esempio, la SIM non dispone di informazioni sul provider preferite di cui è stato effettuato il provisioning. |
|
Il dispositivo non supporta questa operazione. I dispositivi CDMA restituiscono sempre questo valore. |
Commenti
GetPreferredProviders restituisce l'elenco di provider archiviati nell'elenco dei provider preferito dell'interfaccia.
Per gli errori recuperabili E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, il servizio Mobile Broadband eseguirà nuovamente una query sul dispositivo per l'elenco dei provider quando la condizione di errore è finita. Ad esempio, se il dispositivo richiede che venga immesso un PIN per ottenere l'elenco del provider, GetPreferredProviders restituirà E_MBN_PIN_REQUIRED. Quando un'applicazione immette un PIN per sbloccare il dispositivo, il servizio Mobile Broadband tenterà nuovamente di ottenere queste informazioni dal dispositivo.
Quando il sistema operativo esegue una query sul dispositivo per ottenere l'elenco del provider dopo che si è verificato un errore ripristinabile, GetPreferredProviders restituisce immediatamente E_PENDING. Al termine della nuova query, viene inviata una notifica all'applicazione chiamante usando il metodo di callback appropriato. Ad esempio, dopo un'operazione di sblocco pin riuscita, verrà chiamato il metodo OnEnterComplete di IMbnPinEvents . Dopo il ripristino da un errore della scheda SIM, verrà chiamato il metodo OnReadyStateChange di IMbnInterfaceEvents .
Il servizio Mobile Broadband aggiornerà l'applicazione sullo stato di qualsiasi nuova query chiamando il metodo OnPreferredProvidersChange di IMbnInterfaceEvents.
In alcuni casi, l'elenco di provider preferito del dispositivo può essere aggiornato tramite la rete tramite SMS o OTA (aggiornamento over-the-air). Il sistema operativo notifica all'applicazione di qualsiasi modifica nell'elenco dei provider preferito chiamando il metodo OnPreferredProvidersChange di IMbnInterfaceEvents.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |