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	布建檔案的格式不正確
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 未 (簽署，而呼叫端不是行動寬頻操作員應用程式)