ESim 클래스

정의

네임스페이스:

Windows.Networking.NetworkOperators

포함된 SIM(eSIM 또는 eUICC)을 나타내는 클래스입니다. eSIM은 하나 이상의 MNO(모바일 네트워크 운영자)에 속하는 하나 이상의 ID(eSIM 프로필)를 저장합니다. eSIM은 폼 팩터가 아닙니다. SIM 프로필을 관리하는 방법입니다.

참고

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다.

이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

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

상속

Object Platform::Object IInspectable ESim

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)
앱 기능	Microsoft.eSIMManagement_8wekyb3d8bbwe

설명

기존 SIM 카드 모뎀이 MNO(모바일 네트워크 운영자) 네트워크에 등록하는 데 사용할 수 있는 단일 ID를 저장하고 셀룰러 서비스(카드 일반적으로 MNO에 의해 배포됨)를 제공합니다. 그러나 eSIM은 하나 이상의 통신사에 속하는 하나 이상의 ID(eSIM 프로필)를 저장합니다. eSIM은 카드 저장된 eSIM 프로필을 사용하도록 설정하고 사용하지 않도록 설정하여 ID를 전환합니다. eSIM 프로필을 사용하도록 설정하면 eSIM이 나타나고 프로필을 배포한 MNO의 기존 SIM 카드 것처럼 작동합니다. 이러한 방식으로 최종 사용자는 물리적 카드 변경하지 않고 MNO 간에 쉽게 전환할 수 있습니다.

eSIM에 프로필을 설치하는 프로세스에는 몇 가지 단계가 있습니다. 최종 사용자는 일부 식별 정보와 함께 프로필 분산 서버의 URL(Uniform Resource Location)을 포함하는 문자열인 활성화 코드를 제공합니다. 다음으로, eSIM 지원 디바이스는 활성화 코드의 데이터를 사용하여 서버에 연결합니다. 서버는 특정 프로필에 대한 메타데이터를 반환하고 사용자에게 프로필 다운로드 동의를 요청하는 정보와 함께 반환합니다. 동의를 받은 eSIM 지원 디바이스는 프로필을 다운로드하고 프로필 이진 Blob을 eSIM에 보냅니다. 마지막으로 프로필이 eSIM에 성공적으로 기록되면 프로필을 활성화할 준비가 된 것입니다. LpaSvc는 모든 eSIM 관련 작업 요청을 처리하기 위한 서비스입니다. 최종 사용자의 경우 eSIM을 관리하기 위한 UI를 제공하는 eSIM 프로필 관리 페이지가 설정 에 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	검색
1903	18362	Discover(String,String)
1903	18362	DiscoverAsync
1903	18362	DiscoverAsync(String,String)

속성

AvailableMemoryInBytes	SIM 카드 사용 가능한 메모리를 전체 바이트 단위로 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
Eid	eSIM ID(EID)를 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
FirmwareVersion	eSIM 펌웨어 버전을 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
MobileBroadbandModemDeviceId	eSIM을 전달하는 Network MobileBroadbandModem 디바이스의 디바이스 식별자 또는 DeviceInformation ID를 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
Policy	eSIM 관리를 위해 LUI(로컬 사용자 인터페이스)에 eSIM을 표시해야 하는지 여부에 대한 eSIM에 대한 정책을 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
SlotIndex	eSim이 해당하는 0 기반 슬롯 인덱스(슬롯 번호)를 가져옵니다. ESim.SlotIndex는 해당 MobileBroadbandSlotInfo 개체의 Index 속성과 일치합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
State	eSIM의 현재 상태 및 작업 상태 나타내는 eSIM의 상태를 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

메서드

DeleteProfileAsync(String)	지정된 eSIM 프로필을 비동기적으로 삭제합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
Discover()	기본 SMDS 주소를 사용하여 eSIM 프로필 검색 작업을 수행합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
Discover(String, String)	제공된 RSP 서버 주소 및 일치하는 ID에 대해 eSIM 프로필 검색 작업을 수행합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
DiscoverAsync()	기본 SMDS 주소를 사용하여 eSIM 프로필 검색 작업을 비동기적으로 수행합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
DiscoverAsync(String, String)	제공된 RSP 서버 주소 및 일치하는 ID에 대해 eSIM 프로필 검색 작업을 비동기적으로 수행합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
DownloadProfileMetadataAsync(String)	지정된 활성화 코드에 해당하는 eSIM 프로필에 대한 설치 메타데이터를 비동기적으로 다운로드합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
GetProfiles()	eSIM에 저장된 프로필 집합을 가져옵니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.
ResetAsync()	eSIM을 비동기적으로 다시 설정합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

이벤트

ProfileChanged

eSIM 프로필의 컬렉션이 변경되거나 컬렉션에 있는 프로필 중 하나의 속성이 변경되는 경우에 발생합니다. 참고 이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.eSIMManagement_8wekyb3d8bbwe 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.