Metodo IMbnInterface::GetPreferredProviders (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.

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 dei provider preferiti. Se questo metodo restituisce un valore diverso da S_OK, questo parametro è NULL. Quando GetPreferredProviders restituisceS_OK, l'applicazione chiamante deve liberare la memoria allocata chiamando SafeArrayDestroy.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente. preferredProviders contiene valori validi.
E_PENDING	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.
E_MBN_PIN_REQUIRED	Il dispositivo richiede che sia necessario immettere un PIN per questa 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_READ_FAULT)	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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il dispositivo non supporta questa operazione. I dispositivi CDMA restituiranno sempre questo valore.

Commenti

GetPreferredProviders restituisce l'elenco dei provider archiviati nell'elenco di provider preferito dell'interfaccia.

Per gli errori ripristinabili E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, il servizio Mobile Broadband eseguirà di nuovo una query sul dispositivo per l'elenco dei provider quando la condizione di errore è finita. Ad esempio, se il dispositivo richiede l'immissione di un PIN per ottenere l'elenco di 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 dei 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 DEL PIN, 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 SMS o OTA (aggiornamento over-the-air). Il sistema operativo invierà una notifica all'applicazione di qualsiasi modifica nell'elenco di provider preferito chiamando il metodo OnPreferredProvidersChange di IMbnInterfaceEvents.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnInterface

Condividi tramite