Méthode IDot11AdHocManager ::CommitCreatedNetwork (adhoc.h)

Article
02/26/2024

Initialise un réseau créé et valide éventuellement le profil du réseau dans le magasin de profils. Le réseau doit être créé à l’aide de CreateNetwork avant d’appeler CommitCreatedNetwork.

Syntaxe

HRESULT CommitCreatedNetwork(
  [in] IDot11AdHocNetwork *pIAdHoc,
  [in] BOOLEAN            fSaveProfile,
  [in] BOOLEAN            fMakeSavedProfileUserSpecific
);

Paramètres

[in] pIAdHoc

Pointeur vers une interface IDot11AdHocNetwork qui spécifie le réseau à initialiser et à commiter.

[in] fSaveProfile

Paramètre facultatif qui spécifie si un profil sans fil doit être enregistré. Si la valeur est TRUE, le profil est enregistré dans le magasin de profils. Une fois qu’un profil a été enregistré, l’utilisateur peut le modifier à l’aide de l’interface utilisateur Gérer le réseau sans fil . Les profils peuvent également être modifiés à l’aide des fonctions Wifi natives.

L’enregistrement d’un profil modifie la signature réseau retournée par IDot11AdHocNetwork ::GetSignature.

[in] fMakeSavedProfileUserSpecific

Paramètre facultatif qui spécifie si le profil à enregistrer est un profil tout utilisateur. Si la valeur est TRUE, le profil est spécifique à l’utilisateur actuel. S’il est défini sur FALSE, le profil est un profil tout utilisateur qui peut être utilisé par n’importe quel utilisateur connecté à l’ordinateur. Ce paramètre est ignoré si fSaveProfile a la valeur FALSE.

Par défaut, seuls les membres du groupe Administrateurs peuvent conserver un profil tout utilisateur. Ces paramètres de sécurité peuvent être modifiés à l’aide de la fonction WlanSetSecuritySettings . Votre application doit être lancée par un utilisateur disposant de privilèges suffisants pour qu’un profil tout utilisateur soit conservé avec succès.

Si votre application s’exécute dans une fenêtre Bureau à distance, vous pouvez uniquement enregistrer un profil utilisateur. Les profils spécifiques à l’utilisateur ne peuvent pas être enregistrés à partir d’une application exécutée à distance.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_FAIL	La méthode a échoué.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_NOINTERFACE	Une interface spécifiée n’est pas prise en charge.
E_OUTOFMEMORY	La méthode n’a pas pu allouer la mémoire nécessaire pour effectuer cette opération.
E_POINTER	Un pointeur passé en tant que paramètre n’est pas valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	adhoc.h

Voir aussi

IDot11AdHocManager

IDot11AdHocManager ::CreateNetwork

Partager via