ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) 메서드

정의

네임스페이스:

Windows.Networking.NetworkOperators

제공된 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

네트워크 연결 프로비전 정보를 포함하는 CarrierControlSchema 의 인스턴스입니다.

반환

IAsyncOperation<ProvisionFromXmlDocumentResults>

프로비전 시도를 시작하고 완료를 추적하는 비동기 처리기입니다.

특성

RemoteAsyncAttribute

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이 서명되지 않았습니다(호출자가 모바일 광대역 운영자 앱이 아님)