IMbnConnectionProfileManager::CreateConnectionProfile-Methode (mbnapi.h)

  • Artikel

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.

Erstellt ein neues Verbindungsprofil für das Gerät.

Syntax

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

Parameter

[in] xmlProfile

Eine NULL-beendete 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.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 Ein Profil mit dem angegebenen Namen ist bereits vorhanden.
E_MBN_INVALID_PROFILE
 Das Profil entspricht nicht dem Profilschema für mobiles Breitband.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 Der im Profil übergebene Speicherort der Symboldatei ist ungültig oder nicht zugänglich.
E_MBN_DEFAULT_PROFILE_EXIST
 Die aufrufende Anwendung hat das Standardprofilflag in den XML-Daten angegeben, das Standardprofil ist jedoch bereits für das mobile Breitbandgerät vorhanden.

Hinweise

Dies ist ein synchroner Vorgang. Wenn dieser Funktionsaufruf erfolgreich ist, wird ein neues Profil erstellt, und der Mobile Broadband-Dienst ruft die OnConnectionProfileArrival-Methode der IMbnConnectionProfileManagerEvents-Schnittstelle auf.

Wenn der Speicherort der Symboldatei in den Profildaten angegeben ist, kopiert der Mobile Broadband-Dienst die Symboldatei aus dem angegebenen Speicherort in seinem eigenen Speicher. Eine nachfolgende Abfrage für das IMbnConnectionProfile-Objekt für den Speicherort der Symboldatei gibt den Dateispeicherort zurück, an dem der Mobile Broadband-Dienst die Symboldatei gespeichert hat. Wenn ein Profil aus dem System gelöscht wird, wird die Symboldatei auch aus dem System gelöscht. Die Symboldatei sollte im bmp-Dateiformat mit 32 x 32 Pixeldimensionen vorliegen.

Anforderungen

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

Weitere Informationen

IMbnConnectionProfileManager