ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) 方法

定义

命名空间:

Windows.Networking.NetworkOperators

根据提供的 XML 文档异步预配设备以便进行网络连接。

注意

此功能仅适用于移动运营商应用和由移动网络运营商授予特权访问权限的 UWP 应用。

如果要使用此 API 并将应用发布到 Microsoft Store，则需要获得特殊批准。 有关详细信息，请参阅应用功能声明主题中的受限功能部分。

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)

参数

provisioningXmlDocument

String

Platform::String

winrt::hstring

包含网络连接预配信息的 CarrierControlSchema 实例。

返回

IAsyncOperation<ProvisionFromXmlDocumentResults>

一个异步处理程序，用于启动预配尝试并跟踪其完成情况。

属性

RemoteAsyncAttribute

Windows 要求

应用功能	cellularDeviceControl networkConnectionManagerProvisioning networkDataPlanProvisioning cellularDeviceIdentity

注解

完成预配尝试后，可以使用 ProvisionResultsXml 方法检索预配尝试的结果。

ProvisionFromXmlDocumentAsync 以 HRESULT 的形式返回严重错误，这些错误随后会转换为异常。 下面列出了返回的最常见的 HRESULT：

名称	HRESULT	说明
E_ACCESSDENIED	0x80070005L	调用方是操作员应用，但尝试预配其他操作员的配置文件
PROVCORE_E_XML_MALFORMED	0x82170001	预配文件不是格式正确的 XML
PROVCORE_E_XML_INVALID	0x82170002	预配文件不符合架构
PROVCORE_E_XML_SIGNATURE_INVALID	0x82170003	预配文件签名无效
PROVCORE_E_XML_SIGNATURE_UNTRUSTED	0x82170004	签名证书未链接到受信任的根 CA
PROVCORE_E_XML_DIGEST_INVALID	0x82170005	签名后修改了预配文件
PROVCORE_E_XML_SIGNER_UNTRUSTED	0x82170006	用户未批准通过此证书进行预配。
PROVCORE_E_NO_LEAF_CERT	0x82170007	XML 签名中未包含叶证书
PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING	0x8217000D	签名证书不符合扩展验证、数字签名使用) (要求
PROVCORE_E_XML_MISSING_SIGNATURE	0x8217000E	XML 未 (签名，调用方不是移动宽带运营商应用)