ESim Klasse

Definition

Namespace:

Windows.Networking.NetworkOperators

Eine Klasse, die eine eingebettete SIM (eSIM oder eUICC) darstellt. Eine eSIM speichert mindestens eine Identität (eSIM-Profile), die zu einem oder mehreren Mobilfunknetzbetreibern (MNOs) gehören. Eine eSIM ist kein Formfaktor. Es ist eine Möglichkeit, SIM-Profile zu verwalten.

Hinweis

Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten.

Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.

public ref class ESim sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ESim final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ESim

Public NotInheritable Class ESim

Vererbung

Object Platform::Object IInspectable ESim

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)
App-Funktionen	Microsoft.eSIMManagement_8wekyb3d8bbwe

Hinweise

Eine herkömmliche SIM-Karte speichert eine einzelne Identität, die das Modem verwenden kann, um sich im Netzwerk eines Mobilfunknetzbetreibers (MNO) zu registrieren und Mobilfunkdienste bereitzustellen (die Karte wird normalerweise vom MNO verteilt). Eine eSIM speichert jedoch eine oder mehrere Identitäten (eSIM-Profile), die zu einem oder mehreren Mobilfunkanbietern gehören. Eine eSIM wechselt Identitäten, indem die auf dem Karte gespeicherten eSIM-Profile aktiviert und deaktiviert werden. Sobald ein eSIM-Profil aktiviert ist, wird die eSIM angezeigt und funktioniert wie eine herkömmliche SIM-Karte aus dem MNO, der das Profil verteilt hat. Auf diese Weise kann der Endbenutzer problemlos zwischen MNOs wechseln, ohne die physische Karte zu ändern.

Bei der Installation eines Profils auf einer eSIM gibt es mehrere Schritte. Der Endbenutzer stellt einen Aktivierungscode bereit, bei dem es sich um eine Zeichenfolge handelt, die den einheitlichen Ressourcenspeicherort (URL) eines Profilverteilungsservers zusammen mit einigen identifizierenden Informationen enthält. Als Nächstes verwendet das eSIM-fähige Gerät die Daten im Aktivierungscode, um den Server zu kontaktieren. Der Server gibt die Metadaten für ein bestimmtes Profil zusammen mit Informationen zurück, die dem Benutzer angezeigt werden, um die Zustimmung zum Herunterladen des Profils zu bitten. Nach Erhalt der Zustimmung lädt das eSIM-fähige Gerät das Profil herunter und sendet das Binärblob des Profils an die eSIM. Schließlich kann das Profil aktiviert werden, wenn das Profil erfolgreich in die eSIM geschrieben wurde. LpaSvc ist ein Dienst zum Verarbeiten aller eSIM-bezogenen Vorgangsanforderungen. Für Endbenutzer gibt es in den Einstellungen eine Seite Verwalten von eSIM-Profilen, um eine Benutzeroberfläche für die Verwaltung der eSIM bereitzustellen.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1903	18362	Entdecken
1903	18362	Discover(String,String)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync(String,String)

Eigenschaften

AvailableMemoryInBytes	Ruft den verfügbaren Arbeitsspeicher auf der SIM-Karte in ganzen Bytes ab. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
Eid	Ruft die eSIM-ID (EID) ab. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
FirmwareVersion	Ruft die eSIM-Firmwareversion ab. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
MobileBroadbandModemDeviceId	Ruft den Gerätebezeichner oder die DeviceInformation-ID des MobileBroadbandModem-Netzwerkgeräts ab, das die eSIM enthält. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
Policy	Ruft die Richtlinie für die eSIM ab, ob die eSIM auf der lokalen Benutzeroberfläche (Local User Interface, LUI) für die eSIM-Verwaltung angezeigt werden soll. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
SlotIndex	Ruft den 0-basierten Slotindex (Slotnummer) ab, dem die eSim entspricht. ESim.SlotIndex entspricht der Index-Eigenschaft des entsprechenden MobileBroadbandSlotInfo-Objekts . Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
State	Ruft den Status der eSIM ab, der das Vorhandensein und die funktionierende status der eSIM angibt. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.

Methoden

DeleteProfileAsync(String)	Löscht das angegebene eSIM-Profil asynchron. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
Discover()	Führt einen eSIM-Profilermittlungsvorgang unter Verwendung der SMDS-Standardadresse aus. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
Discover(String, String)	Führt einen eSIM-Profilermittlungsvorgang für die angegebene RSP-Serveradresse und die übereinstimmende ID aus. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
DiscoverAsync()	Führt asynchron einen eSIM-Profilermittlungsvorgang unter Verwendung der SMDS-Standardadresse aus. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
DiscoverAsync(String, String)	Führt asynchron einen eSIM-Profilermittlungsvorgang für die angegebene RSP-Serveradresse und die übereinstimmende ID aus. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
DownloadProfileMetadataAsync(String)	Lädt asynchron Installationsmetadaten für das eSIM-Profil herunter, das dem angegebenen Aktivierungscode entspricht. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
GetProfiles()	Ruft den Satz von Profilen ab, die auf der eSIM gespeichert sind. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.
ResetAsync()	Setzt die eSIM asynchron zurück. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.

Ereignisse

ProfileChanged

Tritt auf, wenn sich die Auflistung von eSIM-Profilen ändert oder wenn sich eine Eigenschaft eines der Profile in der Auflistung ändert. Hinweis Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten. Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.eSIMManagement_8wekyb3d8bbwe verwenden zu können. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.