모바일 광대역 Windows 런타임 API 개요

  • 아티클

다음 표에서는 모바일 광대역 앱을 작성하기 위한 API를 나열합니다.

API 설명

연결 프로필 API

연결 상태 대한 정보 제공(예: 인터넷 연결)

Device Services 확장 API

SIM 도구 키트 및 PRL(기본 로밍 목록) 다운로드와 같은 디바이스별 확장을 사용하도록 설정합니다.

프로비저닝 API

계정 프로비저닝 데이터 및 데이터 사용량 정보를 사용하여 Windows를 프로비전할 수 있습니다.

SIM PIN API

SIM PIN을 사용하거나 사용하지 않도록 설정하거나 변경할 수 있습니다.

SMS API

SMS 클라이언트를 구현하는 데 필요한 함수를 제공합니다.

구독자 및 디바이스 정보 API

모바일 광대역 디바이스에 대한 SIM 및 디바이스 정보에 대한 구독자 정보를 제공합니다.

USSD API

네트워크를 사용하여 구조화되지 않은 USSD(보조 서비스 데이터) 세션을 설정할 수 있습니다(클라이언트 및 네트워크가 시작됨).

이 항목에서는 다음 섹션을 사용할 수 있습니다.

모바일 광대역 계정 API

고객에 대한 개인 식별 정보를 얻고 모바일 광대역 디바이스에서 네트워크 설정을 변경하는 데 사용할 수 있는 메서드가 있으므로 모바일 광대역 계정 API는 권한 있는 API입니다. 즉, 대부분의 UWP 앱은 "액세스 거부" 오류가 발생하지 않고 메서드를 호출할 수 없습니다. 이 API를 호출하려면 UWP 앱이 다음 조건을 충족해야 합니다.

  • 앱에는 디바이스 메타데이터 또는 서비스 메타데이터 패키지가 연결되어 있어야 하며 패키지 내의 SoftwareInfo.xml 파일의 PrivilegedApplications XML 요소에 나열되어야 합니다. 패키지는 애플리케이션에만 사용할 필요가 없습니다. 특정 UWP 앱이 여러 패키지의 PrivilegedApplications 요소에 나열될 수 있습니다. 해당 패키지가 설치되도록 컴퓨터에서 한 번 이상 활성화된 모바일 광대역 디바이스의 서비스 공급자와 연결되어야 합니다.

  • 애플리케이션의 appxmanifest 파일에는 모바일 광대역 계정 API에 대한 DeviceCapability> 항목이 필요합니다<. 애플리케이션의 appxmanifest 파일에서 Capabilities> 요소의< 자식으로 다음 XML 요소를 추가하여 이 작업을 수행할 수 있습니다.

    <DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />

    Capabilities> 요소에< 대한 자세한 내용은 Windows 8 앱 매니페스트 파일을 참조하세요.

참고 UWP 앱이 아닌 애플리케이션(예: Microsoft Win32 서비스 또는 데스크톱 앱)은 모바일 광대역 계정 API에 무제한으로 액세스할 수 있습니다. 이러한 애플리케이션은 기존 Win32 및 COM(구성 요소 개체 모델) API를 사용하여 모바일 광대역 네트워크에 대한 모든 권한을 얻을 수 있기 때문입니다. 이러한 API는 UWP 앱에서 사용할 수 없습니다.

네트워크 계정 ID

네트워크 계정 ID는 모바일 광대역 계정의 고유 식별자입니다. ID가 GSM, CDMA 또는 WiMAX 네트워크에서 제공되는지 여부를 알 필요 없이 사용할 수 있는 통합 ID를 제공합니다. Windows는 이전에 발생하지 않은 하드웨어 제공 네트워크 구독 식별자가 발생할 때마다 네트워크 계정 ID를 생성합니다. 다음 목록에서는 지원되는 각 네트워크 유형에 대한 네트워크 계정 ID를 식별합니다.

  • GSM 네트워크: SIM의 ICCID는 구독을 구분하는 데 사용됩니다.

  • CDMA 네트워크: MIN(모바일 ID 번호)이 사용됩니다.

Windows에서 이전 네트워크 유형 중 하나가 처음으로 발견되면 새 네트워크 계정 ID를 만들어 하드웨어에서 제공하는 구독 식별자의 SHA-256 해시에 매핑한 다음 두 가지 모두를 레지스트리에 저장합니다. 반대로 Windows가 레지스트리에서 하드웨어 제공 구독 식별자의 해시를 찾으면 해당 해시와 연결된 네트워크 계정 ID를 사용합니다. 네트워크 계정 ID는 전역적으로 고유해야 하지만(GUID를 기반으로 함) 저장된 것은 하드웨어 제공 식별자의 해시이므로 네트워크 계정 ID를 생성된 ICCID 또는 MIN에 다시 매핑하려고 할 때 네트워크 하드웨어가 있어야 합니다.

중요 네트워크 계정 ID에서 ICCID를 가져오려면 컴퓨터와 이를 함께 매핑하는 데 사용되는 네트워크 디바이스에 액세스해야 하지만 네트워크 계정 ID는 개별 사용자를 고유하게 식별합니다. 따라서 작업할 때 개인 식별 정보를 처리하기 위해 organization 정책을 따르는 것이 좋습니다.

네트워크 계정 ID는 MNO(모바일 네트워크 운영자)로 분리되므로 최종 사용자에게 Provider1 및 Provider2 모바일 광대역 디바이스가 모두 있고 해당 모바일 광대역 앱이 설치된 경우 Provider1 앱은 Provider2 네트워크 계정 ID를 사용할 수 없으며 그 반대의 경우도 마찬가지입니다. 모든 네트워크 계정 ID를 반환하는 함수는 애플리케이션이 함수를 호출하는 MNO에 대한 네트워크 계정의 ID만 반환합니다. 다른 MNO에 속하는 네트워크 계정 ID를 사용하려고 하면 "액세스 거부" 오류가 발생합니다.

참고 UWP 앱이 아닌 앱(예: Win32 서비스 또는 데스크톱 앱)은 네트워크 서비스 공급자에 관계없이 모든 네트워크 계정에 액세스할 수 있습니다.

모바일 광대역 WinRT API 개요