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