ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Handler asinkron untuk memulai upaya provisi dan melacak penyelesaiannya.
- Atribut
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) |