IMbnConnectionProfile::UpdateProfile-Methode (mbnapi.h)

Wichtig

Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.

Updates den Inhalt des Profils.

Syntax

HRESULT UpdateProfile(
  [in] LPCWSTR strProfile
);

Parameter

[in] strProfile

Eine Zeichenfolge, die die Profildaten im XML-Format enthält, das mit der Schemareferenz für mobile Breitbandprofile kompatibel ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_HANDLE	Das Profil ist ungültig und wurde wahrscheinlich aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR _NOT_FOUND)	Das Profil ist ungültig und wurde wahrscheinlich aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Die Profildaten geben eine Symboldatei an, die am angegebenen Speicherort nicht gefunden werden kann.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.

Hinweise

Die von dieser Methode bereitgestellten Daten entsprechen der Schemareferenz für mobiles Breitband.

Diese Methode sollte aufgerufen werden, wenn das Gerät für das Profil im System vorhanden ist.

Dies ist ein synchroner Vorgang. Bei erfolgreicher Ausführung benachrichtigt der Mobile Broadband-Dienst die aufrufende Anwendung, indem er die OnProfileUpdate-Methode der IMbnConnectionProfileEvents-Schnittstelle aufruft .

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnConnectionProfile