ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Aprovisiona un dispositivo para la conectividad de red de forma asincrónica, en función del documento XML proporcionado.
Nota:
Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.
Si quieres usar esta API y publicar tu aplicación en Microsoft Store, necesitarás aprobación especial. Para obtener más información, consulte la sección Funcionalidades restringidas del tema Declaraciones de funcionalidad de la aplicación.
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)Parámetros
- provisioningXmlDocument
-
String
Platform::String
winrt::hstring
Instancia de CarrierControlSchema que contiene la información de aprovisionamiento de conectividad de red.
Devoluciones
Controlador asincrónico para iniciar el intento de aprovisionamiento y realizar un seguimiento de su finalización.
- Atributos
Requisitos de Windows
| Características de aplicaciones |
cellularDeviceControl
networkConnectionManagerProvisioning
networkDataPlanProvisioning
cellularDeviceIdentity
|
Comentarios
Puede recuperar los resultados del intento de aprovisionamiento mediante el método ProvisionResultsXml cuando se haya completado el intento de aprovisionamiento.
ProvisionFromXmlDocumentAsync devuelve errores críticos como HRESULT que luego se traducen en excepciones. Los HRESULT más comunes devueltos se enumeran a continuación:
| Nombre | HRESULT | Descripción |
|---|---|---|
| E_ACCESSDENIED | 0x80070005L | El autor de la llamada es una aplicación de operador, pero se intentó aprovisionar los perfiles de un operador diferente. |
| PROVCORE_E_XML_MALFORMED | 0x82170001 | El archivo de aprovisionamiento no tiene el formato XML correcto |
| PROVCORE_E_XML_INVALID | 0x82170002 | El archivo de aprovisionamiento no se ajusta al esquema |
| PROVCORE_E_XML_SIGNATURE_INVALID | 0x82170003 | La firma del archivo de aprovisionamiento no es válida |
| PROVCORE_E_XML_SIGNATURE_UNTRUSTED | 0x82170004 | El certificado de firma no está encadenado a una entidad de certificación raíz de confianza |
| PROVCORE_E_XML_DIGEST_INVALID | 0x82170005 | El archivo de aprovisionamiento se modificó después de firmarse |
| PROVCORE_E_XML_SIGNER_UNTRUSTED | 0x82170006 | El usuario no ha aprobado el aprovisionamiento de este certificado. |
| PROVCORE_E_NO_LEAF_CERT | 0x82170007 | No se incluyó ningún certificado hoja en la firma XML |
| PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING | 0x8217000D | El certificado de firma no cumple los requisitos (validación extendida, uso de firmas digitales) |
| PROVCORE_E_XML_MISSING_SIGNATURE | 0x8217000E | XML no estaba firmado (y el autor de la llamada no era una aplicación de operador de banda ancha móvil) |