Metodo IMbnConnectionContext::GetProvisionedContexts (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 un elenco di contesti di connessione.
Sintassi
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
Parametri
[out, retval] provisionedContexts
Elenco di valori MBN_CONTEXT che rappresentano i contesti di connessione archiviati nel dispositivo. In caso di errore, questa matrice è NULL. In caso di esito positivo, 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. |
|
I contesti di connessione non sono disponibili. Il servizio Mobile Broadband esegue il probe del dispositivo per le informazioni. L'applicazione chiamante può ricevere una notifica quando i contesti di connessione sono disponibili registrando per il metodo OnProvisionedContextListChange di IMbnConnectionContextEvents. |
|
Per ottenere i contesti di connessione è necessario un PIN. |
|
Una SIM non viene inserita nel dispositivo. |
|
Nel dispositivo viene inserita una SIM non valida. |
|
Il dispositivo non supporta il recupero di contesti di cui è stato effettuato il provisioning. |
Commenti
Un contesto di connessione è un'astrazione di un set specifico di parametri di configurazione di rete per configurare un circuito virtuale o un flusso sopra la connessione Mobile Broadband fisica al livello 2. In GSM corrisponde al concetto di contesto PDP; in CDMA corrisponde a un profilo di rete.
In alcuni casi, i parametri di connessione sono già disponibili nella memoria del dispositivo/SIM. Questo metodo può essere usato per ottenere un elenco di contesti di connessione archiviati nel dispositivo per la rete del provider home corrente.
Per stabilire connessioni dati, è consigliabile usare solo i contesti di tipo MBN_CONTEXT_TYPE_INTERNET .
Un dispositivo restituirà tutti i contesti archiviati per il provider home corrente. Alcuni contesti possono essere vuoti e verranno segnalati come MBN_CONTEXT_TYPE_NONE.
In alcuni casi, i contesti con provisioning archiviati possono essere aggiornati dalla rete tramite SMS o OTA. Ogni volta che si verifica una modifica nei contesti con provisioning del dispositivo, il servizio Mobile Broadband chiamerà il metodo OnProvisionedContextListChange di IMbnConnectionContextEvents. Un'applicazione può quindi usare questo metodo per ottenere l'elenco aggiornato di contesti di cui è stato effettuato il provisioning.
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 queste informazioni quando la condizione di errore è finita. Ad esempio, se il dispositivo richiede l'immissione di un PIN per recuperare i contesti di connessione, restituirà E_MBN_PIN_REQUIRED. Quando l'applicazione immette un PIN per sbloccare il dispositivo, il servizio tenterà nuovamente di ottenere queste informazioni dal dispositivo. Il servizio aggiornerà l'applicazione sullo stato della nuova query chiamando il metodo OnProvisionedContextListChange di IMbnConnectionContextEvents.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |