ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue il provisioning di un dispositivo per la connettività di rete in modo asincrono, in base al documento XML fornito.
Nota
Questa funzionalità è disponibile solo per le app degli operatori mobili e le app UWP date l'accesso con privilegi dagli operatori di rete mobile.
Se si vuole usare questa API e pubblicare l'app in Microsoft Store, sarà necessaria un'approvazione speciale. Per altre informazioni, vedere la sezione Funzionalità limitate nell'argomento Dichiarazioni di funzionalità app.
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)Parametri
- provisioningXmlDocument
-
String
Platform::String
winrt::hstring
Istanza di CarrierControlSchema contenente le informazioni di provisioning della connettività di rete.
Restituisce
Gestore asincrono per avviare il tentativo di provisioning e tenere traccia del completamento.
- Attributi
Requisiti Windows
| Funzionalità dell'app |
cellularDeviceControl
networkConnectionManagerProvisioning
networkDataPlanProvisioning
cellularDeviceIdentity
|
Commenti
È possibile recuperare i risultati del tentativo di provisioning usando il metodo ProvisionResultsXml al termine del tentativo di provisioning.
ProvisionFromXmlDocumentAsync restituisce errori critici come HRESULTs che vengono quindi convertiti in eccezioni. Di seguito sono elencati i più comuni HRESULTs restituiti:
| Nome | HRESULT | Descrizione |
|---|---|---|
| E_ACCESSDENIED | 0x80070005L | Il chiamante è un'app dell'operatore, ma ha tentato di effettuare il provisioning dei profili di un operatore diverso |
| PROVCORE_E_XML_MALFORMED | 0x82170001 | Il file di provisioning non è formato correttamente XML |
| PROVCORE_E_XML_INVALID | 0x82170002 | Il file di provisioning non è conforme allo schema |
| PROVCORE_E_XML_SIGNATURE_INVALID | 0x82170003 | La firma del file di provisioning non è valida |
| PROVCORE_E_XML_SIGNATURE_UNTRUSTED | 0x82170004 | Il certificato di firma non viene concatenato a una CA radice attendibile |
| PROVCORE_E_XML_DIGEST_INVALID | 0x82170005 | Il file di provisioning è stato modificato dopo la firma |
| PROVCORE_E_XML_SIGNER_UNTRUSTED | 0x82170006 | L'utente non ha approvato il provisioning da questo certificato. |
| PROVCORE_E_NO_LEAF_CERT | 0x82170007 | Nessun certificato foglia incluso nella firma XML |
| PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING | 0x8217000D | Il certificato di firma non soddisfa i requisiti (convalida estesa, utilizzo della firma digitale) |
| PROVCORE_E_XML_MISSING_SIGNATURE | 0x8217000E | XML non è stato firmato (e il chiamante non era un'app dell'operatore a banda larga mobile) |