Méthode IDot11AdHocNetwork ::Connect (adhoc.h)

Article
02/23/2024

Se connecte à un réseau sans fil ad hoc créé précédemment. Pour qu’une application puisse se connecter à un réseau, le réseau doit avoir été créé à l’aide de IDot11AdHocManager ::CreateNetwork et engagé à l’aide de IDot11AdHocManager ::CommitCreatedNetwork.

Syntaxe

HRESULT Connect(
  [in] LPCWSTR Passphrase,
  [in] LONG    GeographicalId,
  [in] BOOLEAN fSaveProfile,
  [in] BOOLEAN fMakeSavedProfileUserSpecific
);

Paramètres

[in] Passphrase

Chaîne de mot de passe utilisée pour authentifier l’utilisateur ou l’ordinateur sur le réseau.

La longueur de la chaîne de mot de passe dépend des paramètres de sécurité passés dans le paramètre pSecurity de l’appel CreateNetwork . Le tableau suivant montre la longueur du mot de passe associée à différents paramètres de sécurité.

Paramètres de sécurité	Longueur du mot de passe
Open-None	0
Open-WEP	5 ou 13 caractères ; 10 ou 26 chiffres hexadécimaux
WPA2PSK	8 à 63 caractères

Pour obtenir les valeurs énumérées qui correspondent à la paire de paramètres de sécurité ci-dessus, consultez DOT11_ADHOC_AUTH_ALGORITHM et DOT11_ADHOC_CIPHER_ALGORITHM.

[in] GeographicalId

Emplacement géographique dans lequel le réseau a été créé. Pour obtenir la liste des valeurs possibles, consultez Table des emplacements géographiques.

[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 est 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 enregistrer 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 enregistré 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.

Remarques

Cette méthode est asynchrone. Connect retourne immédiatement S_OK si les paramètres passés à la méthode sont valides. Toutefois, un code de retour de S_OK n’indique pas que la connexion a réussi. Vous devez vous inscrire aux notifications sur l’interface IDot11AdHocNetworkNotificationSink pour être informé de la réussite ou de l’échec de la connexion. La méthode IDot11AdHocNetworkNotificationSink ::OnStatusChange retourne le status de connexion. Pour plus d’informations sur l’inscription aux notifications, consultez IDot11AdHocManager.

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

IDot11AdHocNetwork

IDot11AdHocNetwork ::D isconnect

Partager via