ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) 메서드

정의

제공된 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는 다음과 같습니다.

속성HRESULTDescription
E_ACCESSDENIED0x80070005L호출자는 운영자 앱이지만 다른 연산자의 프로필을 프로비전하려고 시도했습니다.
PROVCORE_E_XML_MALFORMED0x82170001프로비저닝 파일이 올바른 형식의 XML이 아닙니다.
PROVCORE_E_XML_INVALID0x82170002프로비전 파일이 스키마를 준수하지 않음
PROVCORE_E_XML_SIGNATURE_INVALID0x82170003프로비저닝 파일 서명이 잘못되었습니다.
PROVCORE_E_XML_SIGNATURE_UNTRUSTED0x82170004서명 인증서가 신뢰할 수 있는 루트 CA에 연결되지 않음
PROVCORE_E_XML_DIGEST_INVALID0x82170005서명된 후 프로비저닝 파일이 수정되었습니다.
PROVCORE_E_XML_SIGNER_UNTRUSTED0x82170006사용자가 이 인증서의 프로비저닝을 승인하지 않았습니다.
PROVCORE_E_NO_LEAF_CERT0x82170007XML 서명에 리프 인증서가 포함되지 않았습니다.
PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING0x8217000D서명 인증서가 요구 사항을 충족하지 않음(확장 유효성 검사, 디지털 서명 사용)
PROVCORE_E_XML_MISSING_SIGNATURE0x8217000EXML이 서명되지 않았습니다(호출자가 모바일 광대역 운영자 앱이 아님)

적용 대상