Panoramica delle API di Windows Runtime mobile broadband
Nella tabella seguente sono elencate le API per la creazione di un'app mobile broadband.
| API | Descrizione |
|---|---|
Fornisce informazioni sullo stato della connessione (ad esempio, su Internet) |
|
Abilita le estensioni specifiche del dispositivo, ad esempio SIM Toolkit e il download dell'elenco di roaming preferito( PRL). |
|
Consente di effettuare il provisioning di Windows con informazioni sull'utilizzo dei dati e dei dati di provisioning degli account. |
|
Consente di abilitare, disabilitare o modificare il PIN sim. |
|
Fornisce le funzioni necessarie per implementare un client SMS. |
|
Fornisce informazioni sui sottoscrittori per la SIM e le informazioni sul dispositivo mobile broadband. |
|
Consente di stabilire una sessione USSD (Unstructured Supplement Service Data) con una rete (client e rete avviata). |
In questo argomento sono disponibili le sezioni seguenti:
API dell'account Mobile Broadband
Poiché include metodi che possono essere usati per ottenere informazioni personali sul cliente e modificare le impostazioni di rete nei dispositivi mobili a banda larga, l'API Mobile Broadband Account è un'API con privilegi. Ciò significa che la maggior parte delle app UWP non può chiamare i metodi senza ricevere un errore di accesso negato. Per poter chiamare questa API, un'app UWP deve soddisfare i criteri seguenti:
All'app deve essere associato un pacchetto di metadati del dispositivo o di metadati del servizio e deve essere elencato nell'elemento XML PrivilegedApplications del file SoftwareInfo.xml all'interno del pacchetto. Il pacchetto non deve essere esclusivo per l'applicazione; è possibile che qualsiasi app UWP specifica sia elencata nell'elemento PrivilegedApplications di diversi pacchetti. Tale pacchetto deve essere associato al provider di servizi per un dispositivo mobile broadband attivo almeno una volta nel computer, in modo che sia stato installato.
Il file appxmanifest dell'applicazione richiede una <voce DeviceCapability> per l'API Mobile Broadband Account. A tale scopo, aggiungere l'elemento XML seguente come elemento figlio dell'elemento <Capabilities> nel file appxmanifest dell'applicazione:
<DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />Per altre informazioni sull'elemento Capabilities>, vedere File manifesto dell'app<per Windows 8.
Nota Le applicazioni che non sono app UWP (ad esempio, i servizi Microsoft Win32 o le app desktop) hanno accesso senza restrizioni all'API Dell'account Mobile Broadband. Ciò è dovuto al fatto che queste applicazioni possono usare le API Win32 e Component Object Model (COM) esistenti per ottenere l'accesso completo alla rete mobile broadband. Queste API non possono essere usate dalle app UWP.
ID account di rete
Un ID account di rete è un identificatore univoco per un account mobile broadband. Fornisce un ID unificato che può essere usato senza dover sapere se l'ID proviene da una rete GSM, CDMA o WiMAX. Windows genera ID account di rete ogni volta che rileva un identificatore di sottoscrizione di rete fornito dall'hardware che non è stato rilevato in precedenza. L'elenco seguente identifica l'ID dell'account di rete per ogni tipo di rete supportato:
Reti GSM: L'ICCID della SIM viene usato per distinguere le sottoscrizioni.
Reti CDMA: viene usato il numero di identificazione mobile (MIN).
Quando Windows rileva uno dei tipi di rete precedenti per la prima volta, crea un nuovo ID account di rete e lo esegue il mapping a un hash SHA-256 dell'identificatore di sottoscrizione fornito dall'hardware e quindi li archivia nel Registro di sistema. Al contrario, se Windows trova l'hash dell'identificatore di sottoscrizione fornito dall'hardware nel Registro di sistema, usa l'ID dell'account di rete associato a tale hash. Gli ID dell'account di rete devono essere univoci a livello globale (sono basati su GUID), ma poiché ciò che viene archiviato è un hash dell'identificatore fornito dall'hardware, l'hardware di rete deve essere presente quando si tenta di eseguire il mapping di un ID account di rete all'ICCID o min da cui è stato generato.
Importante Anche se il recupero dell'ICCID da un ID account di rete richiede l'accesso al computer e al dispositivo di rete usato per eseguirne il mapping, gli ID dell'account di rete identificano in modo univoco i singoli utenti. È quindi consigliabile seguire i criteri dell'organizzazione per gestire le informazioni personali quando si lavora con tali informazioni.
Gli ID dell'account di rete sono separati dall'operatore di rete mobile (MNO), in modo che se un utente finale dispone sia di dispositivi Provider1 che provider2 mobile broadband e le app mobile broadband corrispondenti vengono installate, l'app Provider1 non sarà in grado di usare gli ID dell'account di rete Provider2 e viceversa. La funzione che restituisce tutti gli ID account di rete restituirà solo gli ID degli account di rete per l'MNO la cui applicazione chiama la funzione. Un tentativo di usare un ID account di rete appartenente a un MNO diverso genererà un errore di accesso negato.
Nota Le app che non sono app UWP (ad esempio, servizi Win32 o app desktop) hanno accesso a tutti gli account di rete indipendentemente dal provider di servizi di rete.