ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Metodo

Definizione

Spazio dei nomi:

Windows.Networking.NetworkOperators

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

IAsyncOperation<ProvisionFromXmlDocumentResults>

Gestore asincrono per avviare il tentativo di provisioning e tenere traccia del completamento.

Attributi

RemoteAsyncAttribute

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)