Metodo IMbnInterface::GetHomeProvider (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 il provider home.
Sintassi
HRESULT GetHomeProvider(
[out, retval] MBN_PROVIDER *homeProvider
);
Parametri
[out, retval] homeProvider
Puntatore a una struttura MBN_PROVIDER che rappresenta il provider home. Se questo metodo restituisce qualsiasi valore diverso da S_OK, questo parametro è NULL. Al termine, l'applicazione chiamante deve liberare la memoria allocata ai membri providerID e providerName di MBN_PROVIDER chiamando SysFreeString
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. homeProvider contiene valori validi. |
|
Le informazioni non sono disponibili. Il servizio Mobile Broadband sta attualmente verificando per ottenere il provider di casa. L'applicazione chiamante può ricevere una notifica quando il provider home è disponibile registrando per il metodo OnHomeProviderAvailable 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 home con provisioning. |
Commenti
GetHomeProvider restituisce le informazioni sul provider home per il dispositivo. Il campo dataClassdella struttura MBN_PROVIDER restituita deve essere ignorato.
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 il provider home quando la condizione di errore è finita. Ad esempio, se il dispositivo richiede l'immissione di un PIN per recuperare queste informazioni, restituirà E_MBN_PIN_REQUIRED. Quando l'applicazione immette il PIN per sbloccare il dispositivo, il servizio Mobile Broadband tenterà nuovamente di ottenere queste informazioni dal dispositivo. Il sistema aggiornerà l'applicazione sullo stato della nuova query chiamando il metodo OnHomeProviderAvailable di IMbnInterfaceEvents.
Il metodo OnHomeProviderAvailable registrato di IMbnInterfaceEvents può essere chiamato quando le informazioni del provider home sono disponibili o la nuova query completata con l'errore. Dopo aver restituito l'esito positivo, queste informazioni non cambieranno mai.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |