ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
제공된 XML 문서에 따라 비동기적으로 네트워크 연결을 위해 디바이스를 프로비전합니다.
참고
이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여한 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다.
이 API를 사용하고 앱을 Microsoft Store에 게시하려면 특별한 승인이 필요합니다. 자세한 내용은 앱 기능 선언 항목의 제한된기능 섹션을 참조하세요 .
public:
virtual IAsyncOperation<ProvisionFromXmlDocumentResults ^> ^ ProvisionFromXmlDocumentAsync(Platform::String ^ provisioningXmlDocument) = ProvisionFromXmlDocumentAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<ProvisionFromXmlDocumentResults> ProvisionFromXmlDocumentAsync(winrt::hstring const& provisioningXmlDocument);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<ProvisionFromXmlDocumentResults> ProvisionFromXmlDocumentAsync(string provisioningXmlDocument);function provisionFromXmlDocumentAsync(provisioningXmlDocument)Public Function ProvisionFromXmlDocumentAsync (provisioningXmlDocument As String) As IAsyncOperation(Of ProvisionFromXmlDocumentResults)매개 변수
- provisioningXmlDocument
-
String
Platform::String
winrt::hstring
네트워크 연결 프로비저닝 정보를 포함하는 CarrierControlSchema의 instance.
반환
프로비전 시도를 시작하고 완료를 추적하는 비동기 처리기입니다.
- 특성
Windows 요구 사항
| 앱 기능 |
cellularDeviceControl
networkConnectionManagerProvisioning
networkDataPlanProvisioning
cellularDeviceIdentity
|
설명
프로비전 시도가 완료되면 ProvisionResultsXml 메서드를 사용하여 프로비전 시도의 결과를 검색할 수 있습니다.
ProvisionFromXmlDocumentAsync는 중요한 오류를 HRESULT로 반환한 다음 예외로 변환합니다. 반환되는 가장 일반적인 HRESULT는 다음과 같습니다.
| 속성 | HRESULT | Description |
|---|---|---|
| E_ACCESSDENIED | 0x80070005L | 호출자는 운영자 앱이지만 다른 연산자의 프로필을 프로비전하려고 시도했습니다. |
| PROVCORE_E_XML_MALFORMED | 0x82170001 | 프로비저닝 파일이 올바른 형식의 XML이 아닙니다. |
| PROVCORE_E_XML_INVALID | 0x82170002 | 프로비전 파일이 스키마를 준수하지 않음 |
| PROVCORE_E_XML_SIGNATURE_INVALID | 0x82170003 | 프로비저닝 파일 서명이 잘못되었습니다. |
| PROVCORE_E_XML_SIGNATURE_UNTRUSTED | 0x82170004 | 서명 인증서가 신뢰할 수 있는 루트 CA에 연결되지 않음 |
| PROVCORE_E_XML_DIGEST_INVALID | 0x82170005 | 서명된 후 프로비저닝 파일이 수정되었습니다. |
| PROVCORE_E_XML_SIGNER_UNTRUSTED | 0x82170006 | 사용자가 이 인증서의 프로비저닝을 승인하지 않았습니다. |
| PROVCORE_E_NO_LEAF_CERT | 0x82170007 | XML 서명에 리프 인증서가 포함되지 않았습니다. |
| PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING | 0x8217000D | 서명 인증서가 요구 사항을 충족하지 않음(확장 유효성 검사, 디지털 서명 사용) |
| PROVCORE_E_XML_MISSING_SIGNATURE | 0x8217000E | XML이 서명되지 않았습니다(호출자가 모바일 광대역 운영자 앱이 아님) |