ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Approvisionne un appareil pour la connectivité réseau de manière asynchrone, en fonction du document XML fourni.
Notes
Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile.
Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités restreintes dans la rubrique Déclarations de fonctionnalités d’application .
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)Paramètres
- provisioningXmlDocument
-
String
Platform::String
winrt::hstring
Instance de CarrierControlSchema qui contient les informations d’approvisionnement de connectivité réseau.
Retours
Gestionnaire asynchrone pour démarrer la tentative d’approvisionnement et suivre son achèvement.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
cellularDeviceControl
networkConnectionManagerProvisioning
networkDataPlanProvisioning
cellularDeviceIdentity
|
Remarques
Vous pouvez récupérer les résultats de la tentative d’approvisionnement à l’aide de la méthode ProvisionResultsXml une fois la tentative d’approvisionnement terminée.
ProvisionFromXmlDocumentAsync retourne des erreurs critiques en tant que HRESULT qui sont ensuite traduites en exceptions. Les HRESULT les plus courants retournés sont répertoriés ci-dessous :
| Nom | HRESULT | Description |
|---|---|---|
| E_ACCESSDENIED | 0x80070005L | L’appelant est une application opérateur, mais a tenté de provisionner les profils d’un opérateur différent |
| PROVCORE_E_XML_MALFORMED | 0x82170001 | Le fichier d’approvisionnement n’est pas correctement formé XML |
| PROVCORE_E_XML_INVALID | 0x82170002 | Le fichier d’approvisionnement n’est pas conforme au schéma |
| PROVCORE_E_XML_SIGNATURE_INVALID | 0x82170003 | La signature du fichier d’approvisionnement n’est pas valide |
| PROVCORE_E_XML_SIGNATURE_UNTRUSTED | 0x82170004 | Le certificat de signature n’est pas chaîné à une autorité de certification racine approuvée |
| PROVCORE_E_XML_DIGEST_INVALID | 0x82170005 | Le fichier d’approvisionnement a été modifié après avoir été signé |
| PROVCORE_E_XML_SIGNER_UNTRUSTED | 0x82170006 | L’utilisateur n’a pas approuvé l’approvisionnement à partir de ce certificat. |
| PROVCORE_E_NO_LEAF_CERT | 0x82170007 | Aucun certificat feuille n’a été inclus dans la signature XML |
| PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING | 0x8217000D | Le certificat de signature ne répond pas aux exigences (validation étendue, utilisation de la signature numérique) |
| PROVCORE_E_XML_MISSING_SIGNATURE | 0x8217000E | XML n’a pas été signé (et l’appelant n’était pas une application d’opérateur haut débit mobile) |