Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |