ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Подготавливает устройство для сетевого подключения асинхронно на основе предоставленного 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 , содержащий сведения о подготовке сетевого подключения.
Возвращаемое значение
Асинхронный обработчик для запуска попытки подготовки и отслеживания ее завершения.
- Атрибуты
Требования к 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 | Сертификат подписи не связан с доверенным корневым ЦС |
| 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 не был подписан (и вызывающий не был приложением оператора мобильной широкополосной связи) |