Übersicht über Windows-Runtime-APIs für mobiles Breitband
In der folgenden Tabelle sind die APIs zum Erstellen einer mobilen Breitband-App aufgeführt.
| API | BESCHREIBUNG |
|---|---|
Stellt Informationen zur Verbindung status (z. B. mit dem Internet) bereit. |
|
Ermöglicht gerätespezifische Erweiterungen, z. B. SIM Toolkit und Download der bevorzugten Roamingliste (PREFERRED Roaming List, PRL). |
|
Ermöglicht es Ihnen, Windows mit Kontobereitstellungsdaten und Datennutzungsinformationen bereitzustellen. |
|
Ermöglicht es Ihnen, die SIM-PIN zu aktivieren, zu deaktivieren oder zu ändern. |
|
Stellt Funktionen bereit, die zum Implementieren eines SMS-Clients erforderlich sind. |
|
Stellt Abonnenteninformationen für die SIM-Karte und Geräteinformationen für das mobile Breitbandgerät bereit. |
|
Ermöglicht es Ihnen, eine USSD-Sitzung (Unstructured Supplementary Service Data) mit einem Netzwerk (client- und netzwerkinitiiert) einzurichten. |
Die folgenden Abschnitte sind in diesem Thema verfügbar:
Api für mobiles Breitbandkonto
Da es Über Methoden verfügt, mit denen persönliche Informationen über den Kunden abgerufen und die Netzwerkeinstellungen auf mobilen Breitbandgeräten geändert werden können, ist die API für mobile Breitbandkonten eine privilegierte API. Dies bedeutet, dass die meisten UWP-Apps ihre Methoden nicht aufrufen können, ohne den Fehler "Zugriff verweigert" zu erhalten. Um diese API aufrufen zu können, muss eine UWP-App die folgenden Kriterien erfüllen:
Der App muss ein Gerätemetadaten- oder Dienstmetadatenpaket zugeordnet sein, und es muss im XML-Element PrivilegedApplications der SoftwareInfo.xml-Datei im Paket aufgeführt sein. Das Paket muss sich nicht ausschließlich auf die Anwendung bezieht; Es ist möglich, dass eine bestimmte UWP-App im PrivilegedApplications-Element mehrerer Pakete aufgeführt wird. Dieses Paket muss dem Dienstanbieter für ein mobiles Breitbandgerät zugeordnet werden, das mindestens einmal auf dem Computer aktiv war, damit es installiert wurde.
Die Appxmanifest-Datei der Anwendung benötigt einen <DeviceCapability-Eintrag> für die Mobile Broadband Account-API. Fügen Sie dazu das folgende XML-Element als untergeordnetes Element des <Capabilities-Elements> in der appxmanifest-Datei der Anwendung hinzu:
<DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />Weitere Informationen zum Capabilities-Element<> finden Sie unter App-Manifestdatei für Windows 8.
Hinweis Anwendungen, bei denen es sich nicht um UWP-Apps handelt (z. B. Microsoft Win32-Dienste oder Desktop-Apps), haben uneingeschränkten Zugriff auf die API für mobile Breitbandkonten. Dies liegt daran, dass diese Anwendungen vorhandene Win32- und COM-APIs (Component Object Model) verwenden können, um vollzugriff auf das mobile Breitbandnetzwerk zu erhalten. Diese APIs können nicht von UWP-Apps verwendet werden.
Netzwerkkonto-IDs
Eine Netzwerkkonto-ID ist ein eindeutiger Bezeichner für ein Konto mit mobilem Breitband. Es bietet eine einheitliche ID, die verwendet werden kann, ohne wissen zu müssen, ob die ID aus einem GSM-, CDMA- oder WiMAX-Netzwerk stammt. Windows generiert Netzwerkkonto-IDs, wenn es auf einen hardwareseitig bereitgestellten Netzwerkabonnementbezeichner stößt, den es bisher noch nicht gefunden hat. In der folgenden Liste wird die Netzwerkkonto-ID für jeden unterstützten Netzwerktyp angegeben:
GSM-Netzwerke: Die ICCID der SIM wird verwendet, um zwischen Abonnements zu unterscheiden.
CDMA-Netzwerke: Die Mobile Identification Number (MIN) wird verwendet.
Wenn Windows zum ersten Mal auf einen der vorherigen Netzwerktypen stößt, erstellt es eine neue Netzwerkkonto-ID und ordnet sie einem SHA-256-Hash des hardwareseitig bereitgestellten Abonnementbezeichners zu und speichert dann beide in der Registrierung. Wenn Windows hingegen den Hash des hardwareseitig bereitgestellten Abonnementbezeichners in der Registrierung findet, verwendet es die Netzwerkkonto-ID, die diesem Hash zugeordnet ist. Netzwerkkonto-IDs sollten global eindeutig sein (sie basieren auf GUIDs). Da jedoch ein Hash des hardwareseitig bereitgestellten Bezeichners gespeichert wird, muss die Netzwerkhardware vorhanden sein, wenn versucht wird, eine Netzwerkkonto-ID der ICCID oder min zuzuordnen, aus der sie generiert wurde.
Wichtig Obwohl das Abrufen der ICCID aus einer Netzwerkkonto-ID Zugriff auf den Computer und das Netzwerkgerät erfordert, die für die Zuordnung verwendet werden, identifizieren Netzwerkkonto-IDs einzelne Benutzer eindeutig. Daher wird empfohlen, dass Sie die Richtlinien Ihrer organization für den Umgang mit personenbezogenen Informationen befolgen, wenn Sie mit ihnen arbeiten.
Netzwerkkonto-IDs werden nach Mobilfunknetzbetreiber (MNO) getrennt, sodass die Provider1-App keine Provider2-Netzwerkkonto-IDs verwenden kann, wenn ein Endbenutzer über mobile Breitbandgeräte von Provider1 und Provider2 verfügt und die entsprechenden mobilen Breitband-Apps installiert sind. Die Funktion, die alle Netzwerkkonto-IDs zurückgibt, gibt nur die IDs der Netzwerkkonten für den MNO zurück, dessen Anwendung die Funktion aufruft. Ein Versuch, eine Netzwerkkonto-ID zu verwenden, die zu einem anderen MNO gehört, führt zu einem Fehler "Zugriff verweigert".
Hinweis Apps, die keine UWP-Apps sind (z. B. Win32-Dienste oder Desktop-Apps), haben Unabhängig vom Netzwerkdienstanbieter Zugriff auf alle Netzwerkkonten.