ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Metode

Definisi

Ruang nama:

Windows.Networking.NetworkOperators

Menyediakan perangkat untuk konektivitas jaringan secara asinkron, berdasarkan dokumen XML yang disediakan.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan menerbitkan aplikasi anda ke Microsoft Store, maka Anda akan memerlukan persetujuan khusus. Untuk informasi selengkapnya, lihat bagian Kemampuan terbatas dalam topik Deklarasi kemampuan aplikasi .

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)

Parameter

provisioningXmlDocument

String

Platform::String

winrt::hstring

Instans CarrierControlSchema yang berisi informasi provisi konektivitas jaringan.

Mengembalikan

IAsyncOperation<ProvisionFromXmlDocumentResults>

Handler asinkron untuk memulai upaya provisi dan melacak penyelesaiannya.

Atribut

RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

cellularDeviceControl networkConnectionManagerProvisioning networkDataPlanProvisioning cellularDeviceIdentity

Keterangan

Anda dapat mengambil hasil upaya provisi menggunakan metode ProvisionResultsXml ketika upaya provisi telah selesai.

ProvisionFromXmlDocumentAsync mengembalikan kesalahan penting sebagai HRESULT yang kemudian diterjemahkan ke dalam pengecualian. HRESULT yang paling umum dikembalikan tercantum di bawah ini:

Nama	HRESULT	Deskripsi
E_ACCESSDENIED	0x80070005L	Penelepon adalah aplikasi operator, tetapi mencoba menyediakan profil operator yang berbeda
PROVCORE_E_XML_MALFORMED	0x82170001	File provisi bukan XML yang terbentuk dengan baik
PROVCORE_E_XML_INVALID	0x82170002	File provisi tidak sesuai dengan skema
PROVCORE_E_XML_SIGNATURE_INVALID	0x82170003	Tanda tangan file provisi tidak valid
PROVCORE_E_XML_SIGNATURE_UNTRUSTED	0x82170004	Sertifikat penandatanganan tidak ditautkan ke CA akar tepercaya
PROVCORE_E_XML_DIGEST_INVALID	0x82170005	File provisi diubah setelah ditandatangani
PROVCORE_E_XML_SIGNER_UNTRUSTED	0x82170006	Pengguna tidak menyetujui provisi dari sertifikat ini.
PROVCORE_E_NO_LEAF_CERT	0x82170007	Tidak ada sertifikat daun yang disertakan dalam tanda tangan XML
PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING	0x8217000D	Sertifikat penandatanganan tidak memenuhi persyaratan (Validasi Diperpanjang, penggunaan tanda tangan digital)
PROVCORE_E_XML_MISSING_SIGNATURE	0x8217000E	XML tidak ditandatangani (dan pemanggil bukan aplikasi operator broadband seluler)