ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Gerät für die Netzwerkkonnektivität basierend auf dem angegebenen XML-Dokument asynchron bereit.
Hinweis
Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung.
Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, benötigen Sie eine spezielle Genehmigung. Weitere Informationen finden Sie im Abschnitt Eingeschränkte Funktionen im Thema App-Funktionsdeklarationen .
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
Ein instance von CarrierControlSchema, das die Informationen zur Bereitstellung der Netzwerkkonnektivität enthält.
Gibt zurück
Ein asynchroner Handler, um den Bereitstellungsversuch zu starten und dessen Abschluss nachzuverfolgen.
- Attribute
Windows-Anforderungen
| App-Funktionen |
cellularDeviceControl
networkConnectionManagerProvisioning
networkDataPlanProvisioning
cellularDeviceIdentity
|
Hinweise
Sie können die Ergebnisse des Bereitstellungsversuchs mit der ProvisionResultsXml-Methode abrufen, wenn der Bereitstellungsversuch abgeschlossen ist.
ProvisionFromXmlDocumentAsync gibt kritische Fehler als HRESULTs zurück, die dann in Ausnahmen übersetzt werden. Die am häufigsten zurückgegebenen HRESULTs sind unten aufgeführt:
| Name | HRESULT | BESCHREIBUNG |
|---|---|---|
| E_ACCESSDENIED | 0x80070005L | Aufrufer ist eine Operator-App, hat aber versucht, die Profile eines anderen Operators bereitzustellen. |
| PROVCORE_E_XML_MALFORMED | 0x82170001 | Die Bereitstellungsdatei ist kein wohlgeformtes XML |
| PROVCORE_E_XML_INVALID | 0x82170002 | Die Bereitstellungsdatei entspricht nicht dem Schema. |
| PROVCORE_E_XML_SIGNATURE_INVALID | 0x82170003 | Die Signatur der Bereitstellungsdatei ist ungültig. |
| PROVCORE_E_XML_SIGNATURE_UNTRUSTED | 0x82170004 | Signaturzertifikat ist nicht mit einer vertrauenswürdigen Stammzertifizierungsstelle verkettet |
| PROVCORE_E_XML_DIGEST_INVALID | 0x82170005 | Die Bereitstellungsdatei wurde nach der Signatur geändert. |
| PROVCORE_E_XML_SIGNER_UNTRUSTED | 0x82170006 | Der Benutzer hat die Bereitstellung aus diesem Zertifikat nicht genehmigt. |
| PROVCORE_E_NO_LEAF_CERT | 0x82170007 | In der XML-Signatur war kein Blattzertifikat enthalten. |
| PROVCORE_E_SIGNING_CERTIFICATE_INVALID_FOR_SIGNING | 0x8217000D | Signaturzertifikat erfüllt nicht die Anforderungen (erweiterte Validierung, Verwendung digitaler Signaturen) |
| PROVCORE_E_XML_MISSING_SIGNATURE | 0x8217000E | XML wurde nicht signiert (und der Anrufer war keine Mobile-Breitband-Betreiber-App). |