IMbnConnectionProfileManager::CreateConnectionProfile-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.
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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Ein Profil mit dem angegebenen Namen ist bereits vorhanden. |
|
Das Profil entspricht nicht dem Profilschema für mobiles Breitband. |
|
Der im Profil übergebene Speicherort der Symboldatei ist ungültig oder nicht zugänglich. |
|
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 |