Méthode IMbnConnectionProfileManager::CreateConnectionProfile (mbnapi.h)

Article
08/24/2023

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
S_OK	La commande s'est correctement terminée.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Un profil portant le nom donné existe déjà.
E_MBN_INVALID_PROFILE	Le profil n’est pas conforme au schéma de profil haut débit mobile.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	L’emplacement du fichier d’icône passé dans le profil n’est pas valide ou n’est pas accessible.
E_MBN_DEFAULT_PROFILE_EXIST	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

Voir aussi

IMbnConnectionProfileManager

Partager via