ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Método

Definição

Namespace:

Windows.Networking.NetworkOperators

Provisiona um dispositivo para conectividade de rede de forma assíncrona, com base no documento XML fornecido.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo.

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

Uma instância de CarrierControlSchema que contém as informações de provisionamento de conectividade de rede.

Retornos

IAsyncOperation<ProvisionFromXmlDocumentResults>

Um manipulador assíncrono para iniciar a tentativa de provisionamento e acompanhar sua conclusão.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

cellularDeviceControl networkConnectionManagerProvisioning networkDataPlanProvisioning cellularDeviceIdentity

Comentários

Você pode recuperar os resultados da tentativa de provisionamento usando o método ProvisionResultsXml quando a tentativa de provisionamento for concluída.

ProvisionFromXmlDocumentAsync retorna erros críticos como HRESULTs que são convertidos em exceções. Os HRESULTs mais comuns retornados estão listados abaixo:

Nome	HRESULT	Descrição
E_ACCESSDENIED	0x80070005L	O chamador é um aplicativo operador, mas tentou provisionar perfis de um operador diferente
PROVCORE_E_XML_MALFORMED	0x82170001	O arquivo de provisionamento não é XML bem formado
PROVCORE_E_XML_INVALID	0x82170002	O arquivo de provisionamento não está em conformidade com o esquema
PROVCORE_E_XML_SIGNATURE_INVALID	0x82170003	A assinatura do arquivo de provisionamento é inválida
PROVCORE_E_XML_SIGNATURE_UNTRUSTED	0x82170004	O certificado de autenticação não é encadeado a uma AC raiz confiável
PROVCORE_E_XML_DIGEST_INVALID	0x82170005	O arquivo de provisionamento foi modificado após ser assinado
PROVCORE_E_XML_SIGNER_UNTRUSTED	0x82170006	O usuário não aprovou o provisionamento desse certificado.
PROVCORE_E_NO_LEAF_CERT	0x82170007	Nenhum certificado folha foi incluído na assinatura XML
PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING	0x8217000D	O certificado de assinatura não atende aos requisitos (Validação Estendida, uso de assinatura digital)
PROVCORE_E_XML_MISSING_SIGNATURE	0x8217000E	O XML não foi assinado (e o chamador não era um aplicativo de operadora de banda larga móvel)