ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um manipulador assíncrono para iniciar a tentativa de provisionamento e acompanhar sua conclusão.
- Atributos
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) |