ProvisioningAgent.ProvisionFromXmlDocumentAsync | provisionFromXmlDocumentAsync method

Applies to Windows and Windows Phone

Provisions a device for network connectivity asynchronously, based on the supplied XML document.

Note  This functionality is only available to mobile operator apps and Windows Store apps given privileged access by mobile network operators. For more information, see Mobile Broadband: Windows Store device apps.

Syntax

Public Function ProvisionFromXmlDocumentAsync(
  provisioningXmlDocument As String 
) As IAsyncOperation(Of ProvisionFromXmlDocumentResults)

Parameters

provisioningXmlDocument

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

An instance of CarrierControlSchema that contains the network connectivity provisioning information.

Return value

Type: IAsyncOperation<ProvisionFromXmlDocumentResults>

An asynchronous handler to start the provisioning attempt and track its completion.

Remarks

You can retrieve the results of the provisioning attempt using the ProvisionResultsXml method when the provisioning attempt has completed.

ProvisionFromXmlDocumentAsync returns critical errors as HRESULTs that are then translated into exceptions. The most common HRESULTs returned are listed below:

NameHRESULTDescription
E_ACCESSDENIED0x80070005L Caller is an operator app, but attempted to provision a different operator’s profiles
PROVCORE_E_XML_MALFORMED0x82170001Provisioning file is not well-formed XML
PROVCORE_E_XML_INVALID 0x82170002Provisioning file does not conform to schema
PROVCORE_E_XML_SIGNATURE_INVALID0x82170003Provisioning file signature is invalid
PROVCORE_E_XML_SIGNATURE_UNTRUSTED0x82170004Signing certificate is not chained to a trusted root CA
PROVCORE_E_XML_DIGEST_INVALID0x82170005Provisioning file was modified after being signed
PROVCORE_E_XML_SIGNER_UNTRUSTED0x82170006User did not approve provisioning from this certificate.
PROVCORE_E_NO_LEAF_CERT0x82170007No leaf certificate was included in XML signature
PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING0x8217000DSigning certificate does not meet requirements (Extended Validation, digital signature usage)
PROVCORE_E_XML_MISSING_SIGNATURE0x8217000EXML was not signed (and caller was not a mobile broadband operator app)

 

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.Networking.NetworkOperators
Windows::Networking::NetworkOperators [C++]

Metadata

Windows.winmd

See also

ProvisioningAgent

 

 

Show:
© 2014 Microsoft