Méthode IMbnConnectionProfileManager::CreateConnectionProfile (mbnapi.h)
Important
À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
Crée un profil de connexion pour l’appareil.
Syntaxe
HRESULT CreateConnectionProfile(
[in] LPCWSTR xmlProfile
);
Paramètres
[in] xmlProfile
Chaîne terminée par null qui contient les données de profil au format XML conforme à la référence du schéma de profil haut débit mobile.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Un profil portant le nom donné existe déjà. |
|
Le profil n’est pas conforme au schéma de profil haut débit mobile. |
|
L’emplacement du fichier d’icône passé dans le profil n’est pas valide ou n’est pas accessible. |
|
L’application appelante a spécifié l’indicateur de profil par défaut dans les données XML, mais le profil par défaut existe déjà pour l’appareil Haut débit mobile. |
Notes
Il s’agit d’une opération synchrone. Si cet appel de fonction réussit, un nouveau profil est créé et le service haut débit mobile appelle la méthode OnConnectionProfileArrival de l’interface IMbnConnectionProfileManagerEvents .
Si l’emplacement du fichier d’icône est spécifié dans les données de profil, le service Haut débit mobile copie le fichier d’icône à partir de l’emplacement spécifié dans son propre magasin. Une requête suivante sur l’objet IMbnConnectionProfile pour l’emplacement du fichier d’icône retourne l’emplacement du fichier où le service Haut débit mobile a stocké le fichier d’icône. Chaque fois qu’un profil est supprimé du système, son fichier d’icône est également supprimé du système. Le fichier d’icône doit être au format bmp avec des dimensions de 32 x 32 pixels.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |