fonction de rappel DOT11EXT_SET_DEFAULT_KEY (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

La DLL extensions IHV appelle la fonction Dot11ExtSetDefaultKey pour ajouter ou supprimer une clé de chiffrement à partir de la clé par défaut ou des tables de clés par station par station de l’adaptateur RÉSEAU local 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 via un appel précédent à la fonction de 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é peut être utilisée uniquement pour les paquets reçus (DOT11_DIR_INBOUND) ou les paquets reçus et envoyés (DOT11_DIR_BOTH).

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

Valeur de retour

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

Remarques

Un appel à la fonction Dot11ExtSetDefaultKey aboutit à une requête définie 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 MacAddr membre du DOT11_CIPHER_DEFAULT_KEY_VALUE structure à une valeur de 0x000000000000. Une clé de chiffrement par station par défaut est définie en définissant le membre MacAddr sur une adresse MAC (Unicast Media Access Control) valide.

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

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)