ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Método

Definición

Espacio de nombres:

Windows.Networking.NetworkOperators

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

IAsyncOperation<ProvisionFromXmlDocumentResults>

Controlador asincrónico para iniciar el intento de aprovisionamiento y realizar un seguimiento de su finalización.

Atributos

RemoteAsyncAttribute

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)