Méthode IDot11AdHocNetwork ::Connect (adhoc.h)
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 |
|---|---|
|
La commande s'est correctement terminée. |
|
La méthode a échoué. |
|
L’un des paramètres n’est pas valide. |
|
Une interface spécifiée n’est pas prise en charge. |
|
La méthode n’a pas pu allouer la mémoire nécessaire pour effectuer cette opération. |
|
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 |