fonction de rappel DOT11EXT_SET_DEFAULT_KEY_ID (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 Dot11ExtSetDefaultKeyId pour définir l’index de table de la clé de chiffrement par défaut ou par station avec laquelle l’adaptateur LAN sans fil (WLAN) utilise par défaut lors du chiffrement des données de paquet transmises.

Syntaxe

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

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] uDefaultKeyId

Valeur d’index de la clé dans les tables de clé de chiffrement par défaut ou par station de l’adaptateur.

Pour les algorithmes de chiffrement standard 802.11, tels que WEP ou TKIP, uDefaultKeyId doit être comprise entre 0 et 3. Pour un algorithme de chiffrement propriétaire développé par un IHV, uDefaultKeyId peut être n’importe quelle valeur dans la plage définie par l’IHV.

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

L’identificateur de clé par défaut (ID) spécifie l’index d’une clé de chiffrement dans la clé par défaut de l’adaptateur et les tables de clés par défaut par station que l’adaptateur utilise pour le chiffrement des données. L’adaptateur utilise la clé de chiffrement référencée par l’ID de clé par défaut comme clé de chiffrement par défaut pour les paquets transmis, sauf s’il existe une clé de mappage de clés pour l’adresse MAC (Destination Media Access Control). Pour plus d’informations sur ces types de clés de chiffrement, consultez Types de clés de chiffrement 802.11.

Un appel à la fonction Dot11ExtSetDefaultKeyId aboutit à une demande de jeu du OID_DOT11_CIPHER_DEFAULT_KEY_ID identificateur d’objet (OID) au pilote miniport Native 802.11, qui gère l’adaptateur WLAN.

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)

Voir aussi

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 Types de clés de chiffrement

Partager via