Freigeben über


ESim Klasse

Definition

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ESim final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ESim
[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

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.

Gilt für: