DOT11EXT_SET_DEFAULT_KEY fonction de rappel (wlanihv.h)

Article
03/01/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La DLL des extensions IHV appelle la fonction Dot11ExtSetDefaultKey pour ajouter ou supprimer une clé de chiffrement à partir des tables de clés par défaut ou par station par défaut de l’adaptateur LAN sans fil (WLAN). Pour plus d’informations sur ces types de clés, consultez 802.11 Types de clés de chiffrement.

Syntaxe

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation pour référencer l’adaptateur WLAN. Cette valeur de handle a été spécifiée lors d’un appel précédent à la fonction gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] pKey

Pointeur vers un DOT11_CIPHER_DEFAULT_KEY_VALUE structure, qui définit la clé de chiffrement.

[in] dot11Direction

Valeur DOT11_DIRECTION qui spécifie si la clé ne peut être utilisée que pour les paquets reçus (DOT11_DIR_INBOUND) ou les paquets reçus et envoyés (DOT11_DIR_BOTH).

Note La DLL des extensions IHV ne doit pas passer une valeur de DOT11_DIR_OUTBOUND à ce paramètre.

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il retourne un code d’erreur défini dans Winerror.h.

Remarques

Un appel à la fonction Dot11ExtSetDefaultKey aboutit à une demande de jeu du OID_DOT11_CIPHER_DEFAULT_KEY identificateur d’objet à l’adaptateur WLAN.

Une clé de chiffrement par défaut est définie en définissant le membre MacAddr du DOT11_CIPHER_DEFAULT_KEY_VALUE structure à une valeur de 0x000000000000. Une clé de chiffrement par défaut par station est définie en définissant le membre MacAddr sur une adresse de contrôle d’accès multimédia (MAC) en unidiffusion valide.

Une clé de chiffrement est supprimée des tables de clés de l’adaptateur si le membre bDelete du DOT11_CIPHER_DEFAULT_KEY_VALUE structure est définie sur TRUE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (inclure Wlanihv.h)