ProvisioningAgent.ProvisionFromXmlDocumentAsync | provisionFromXmlDocumentAsync method
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.
public: IAsyncOperation<ProvisionFromXmlDocumentResults>^ ProvisionFromXmlDocumentAsync( String^ provisioningXmlDocument )
An instance of CarrierControlSchema that contains the network connectivity provisioning information.
An asynchronous handler to start the provisioning attempt and track its completion.
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:
|E_ACCESSDENIED||0x80070005L||Caller is an operator app, but attempted to provision a different operator’s profiles|
|PROVCORE_E_XML_MALFORMED||0x82170001||Provisioning file is not well-formed XML|
|PROVCORE_E_XML_INVALID||0x82170002||Provisioning file does not conform to schema|
|PROVCORE_E_XML_SIGNATURE_INVALID||0x82170003||Provisioning file signature is invalid|
|PROVCORE_E_XML_SIGNATURE_UNTRUSTED||0x82170004||Signing certificate is not chained to a trusted root CA|
|PROVCORE_E_XML_DIGEST_INVALID||0x82170005||Provisioning file was modified after being signed|
|PROVCORE_E_XML_SIGNER_UNTRUSTED||0x82170006||User did not approve provisioning from this certificate.|
|PROVCORE_E_NO_LEAF_CERT||0x82170007||No leaf certificate was included in XML signature|
|PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING||0x8217000D||Signing certificate does not meet requirements (Extended Validation, digital signature usage)|
|PROVCORE_E_XML_MISSING_SIGNATURE||0x8217000E||XML was not signed (and caller was not a mobile broadband operator app)|
Minimum supported client
Minimum supported server
|Windows Server 2012|
Minimum supported phone
|Windows Phone 8.1 [Windows Runtime apps only]|