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 が署名されていません (呼び出し元がモバイル ブロードバンド オペレーター アプリではなかった)