IDot11AdHocManager ::CreateNetwork, méthode (adhoc.h)

Article
08/22/2023

Crée un réseau ad hoc sans fil. D’autres clients et hôtes peuvent se connecter à ce réseau.

Syntaxe

HRESULT CreateNetwork(
  [in]  LPCWSTR                     Name,
  [in]  LPCWSTR                     Password,
  [in]  LONG                        GeographicalId,
  [in]  IDot11AdHocInterface        *pInterface,
  [in]  IDot11AdHocSecuritySettings *pSecurity,
  [in]  GUID                        *pContextGuid,
  [out] IDot11AdHocNetwork          **pIAdHoc
);

Paramètres

[in] Name

Nom convivial du réseau. Cette chaîne doit être limitée à 32 caractères. Le SSID doit être utilisé comme nom convivial. Ce nom est diffusé dans une balise.

[in] Password

Mot de passe utilisé pour l’authentification de l’ordinateur ou de l’utilisateur 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 . Le tableau suivant indique 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 connaître 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 sera créé. Pour obtenir la liste des valeurs possibles, consultez La table des emplacements géographiques.

Si l’interface n’est pas conforme à 802.11d, cette valeur est ignorée. Cela signifie que si IDot11AdHocInterface ::IsDot11d retourne FALSE, cette valeur est ignorée.

Si vous ne savez pas quelle valeur utiliser, définissez GeographicalId sur CTRY_DEFAULT. Si vous utilisez CTRY_DEFAULT, la conformité 802.11d n’est pas appliquée.

[in] pInterface

Pointeur facultatif vers un IDot11AdHocInterface qui spécifie l’interface réseau sur laquelle le nouveau réseau est créé. Si ce paramètre a la valeur NULL, la première interface inutilisée est utilisée. Si toutes les interfaces sont utilisées, la première interface énumérée est utilisée. Dans ce cas, le réseau précédent sur l’interface est déconnecté.

[in] pSecurity

Pointeur vers une interface IDot11AdHocSecuritySettings qui spécifie les paramètres de sécurité utilisés sur le réseau.

[in] pContextGuid

Paramètre facultatif qui spécifie le GUID de l’application qui a créé le réseau. Une application peut utiliser cet identificateur pour limiter les réseaux énumérés par GetIEnumDot11AdHocNetworks aux réseaux créés par l’application. Pour que ce filtrage fonctionne correctement, toutes les instances de l’application sur toutes les machines doivent utiliser le même GUID.

[out] pIAdHoc

Pointeur vers une interface IDot11AdHocNetwork qui représente le réseau créé.

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	Échec de la méthode.
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.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Un réseau portant le nom spécifié existe déjà.
HRESULT_FROM_WIN32(ERROR_NOT_READY)	L’interface pInterface signale que sa radio est désactivée.
HRESULT_FROM_WIN32(ERROR_NOT_CAPABLE)	L’interface pInterface signale qu’elle n’est pas capable de former un réseau ad hoc. Cette condition peut se produire parce que la carte réseau ne prend pas en charge les réseaux ad hoc, ou parce que la carte réseau ne prend pas en charge les paramètres de sécurité fournis par pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Les paramètres pSecurity ne sont pas pris en charge par l’interface pInterface .
HRESULT_FROM_WIN32(ERROR_ILL_FORMED_PASSWORD)	Le mot de passe fourni n’est pas valide. Le mot de passe fourni peut être une longueur non valide pour les paramètres de sécurité fournis par pSecurity.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Une interface réseau sans fil carte est introuvable sur l’ordinateur.
HRESULT_FROM_WIN32(ERROR_CURRENT_DOMAIN_NOT_ALLOWED)	Les paramètres de stratégie de groupe ou d’administration interdisent la création du réseau.

Remarques

Après un appel CreateNetwork réussi, l’objet réseau retourné par pIAdHoc est provisionné mais non construit. Un appel suivant à CommitCreatedNetwork initialise le réseau. Les balises ne sont pas envoyées tant que le réseau n’est pas commité.

Aucun client ou hôte n’est connecté au réseau après un appel CreateNetwork . Les applications sont averties des tentatives de connexion réussies et ayant échoué à l’aide de l’interface IDot11AdHocManagerNotificationSink . Pour plus d’informations sur l’inscription aux notifications sur cette interface, 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

CommitCreatedNetwork

IDot11AdHocManager

Partager via