ProvisioningAgent.ProvisionFromXmlDocumentAsync(String) Methode

Definition

Namespace:

Windows.Networking.NetworkOperators

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

IAsyncOperation<ProvisionFromXmlDocumentResults>

Ein asynchroner Handler, um den Bereitstellungsversuch zu starten und dessen Abschluss nachzuverfolgen.

Attribute

RemoteAsyncAttribute

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).