Vue d’ensemble des API de Windows Runtime haut débit mobile
Le tableau suivant répertorie les API permettant de créer une application haut débit mobile.
| API | Description |
|---|---|
Fournit des informations sur la connexion status (par exemple, à Internet) |
|
Active les extensions spécifiques à l’appareil, telles que sim Toolkit et le téléchargement de la liste d’itinérance préférée (PRL). |
|
Vous permet d’approvisionner Windows avec des données d’approvisionnement de compte et des informations d’utilisation des données. |
|
Vous permet d’activer, de désactiver ou de modifier le code PIN de la CARTE SIM. |
|
Fournit des fonctions requises pour implémenter un client SMS. |
|
Fournit des informations sur l’abonné pour la carte SIM et des informations sur l’appareil haut débit mobile. |
|
Vous permet d’établir une session USSD (Données de service supplémentaires non structurées) avec un réseau (lancé par le client et le réseau). |
Les sections suivantes sont disponibles dans cette rubrique :
API de compte haut débit mobile
Étant donné qu’elle dispose de méthodes qui peuvent être utilisées pour obtenir des informations d’identification personnelle sur le client et modifier les paramètres réseau sur les appareils haut débit mobiles, l’API compte haut débit mobile est une API privilégiée. Cela signifie que la plupart des applications UWP ne peuvent pas appeler ses méthodes sans obtenir une erreur « accès refusé ». Pour pouvoir appeler cette API, une application UWP doit répondre aux critères suivants :
L’application doit avoir un package de métadonnées de service ou de métadonnées d’appareil associé, et il doit être répertorié dans l’élément XML PrivilegedApplications du fichier SoftwareInfo.xml à l’intérieur du package. Le package ne doit pas être exclusif à l’application ; il est possible qu’une application UWP particulière soit répertoriée dans l’élément PrivilegedApplications de plusieurs packages. Ce package doit être associé au fournisseur de services pour un appareil haut débit mobile qui a été actif au moins une fois sur l’ordinateur, afin qu’il ait été installé.
Le fichier appxmanifest de l’application a besoin d’une <entrée DeviceCapability> pour l’API compte haut débit mobile. Pour ce faire, ajoutez l’élément XML suivant en tant qu’enfant de l’élément <Capabilities> dans le fichier appxmanifest de l’application :
<DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />Pour plus d’informations sur l’élément <Capabilities>, consultez Fichier manifeste d’application pour Windows 8.
Note Les applications qui ne sont pas des applications UWP (par exemple, les services Microsoft Win32 ou les applications de bureau) ont un accès illimité à l’API de compte haut débit mobile. En effet, ces applications peuvent utiliser des API Win32 et COM (Component Object Model) existantes pour obtenir un accès complet au réseau haut débit mobile. Ces API ne peuvent pas être utilisées à partir d’applications UWP.
ID de compte réseau
Un ID de compte réseau est un identificateur unique pour un compte haut débit mobile. Il fournit un ID unifié qui peut être utilisé sans avoir à savoir si l’ID provient d’un réseau GSM, CDMA ou WiMAX. Windows génère des ID de compte réseau chaque fois qu’il rencontre un identificateur d’abonnement réseau fourni par le matériel qu’il n’a pas rencontré auparavant. La liste suivante identifie l’ID de compte réseau pour chaque type de réseau pris en charge :
Réseaux GSM : l’ICCID de la CARTE SIM est utilisé pour différencier les abonnements.
Réseaux CDMA : le numéro d’identification mobile (MIN) est utilisé.
Lorsque Windows rencontre l’un des types de réseau précédents pour la première fois, il crée un ID de compte réseau et le mappe à un hachage SHA-256 de l’identificateur d’abonnement fourni par le matériel, puis les stocke dans le Registre. À l’inverse, si Windows trouve le hachage de l’identificateur d’abonnement fourni par le matériel dans le Registre, il utilise l’ID de compte réseau associé à ce hachage. Les ID de compte réseau doivent être globalement uniques (ils sont basés sur des GUID), mais étant donné que ce qui est stocké est un hachage de l’identificateur fourni par le matériel, le matériel réseau doit être présent lors de la tentative de mappage d’un ID de compte réseau à l’ICCID ou au MIN à partir duquel il a été généré.
Important Même si l’obtention de l’ICCID à partir d’un ID de compte réseau nécessite l’accès à l’ordinateur et à l’appareil réseau qui sont utilisés pour les mapper ensemble, les ID de compte réseau identifient de manière unique les utilisateurs individuels. Par conséquent, nous vous recommandons de suivre les politiques de votre organization pour traiter les informations d’identification personnelle lorsque vous travaillez avec eux.
Les ID de compte réseau sont séparés par l’opérateur de réseau mobile (MNO), de sorte que si un utilisateur final dispose à la fois d’appareils haut débit mobiles Provider1 et Provider2 et que ses applications haut débit mobiles correspondantes sont installées, l’application Provider1 ne peut pas utiliser d’ID de compte réseau Provider2, et vice versa. La fonction qui retourne tous les ID de compte réseau retourne uniquement les ID des comptes réseau pour l’authentification multifacteur dont l’application appelle la fonction. Une tentative d’utilisation d’un ID de compte réseau qui appartient à un autre MNO génère une erreur « accès refusé ».
Note Les applications qui ne sont pas des applications UWP (par exemple, les services Win32 ou les applications de bureau) ont accès à tous les comptes réseau, quel que soit le fournisseur de services réseau.