fonction de rappel DOT11EXT_SET_KEY_MAPPING_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 des extensions IHV appelle la fonction Dot11ExtSetKeyMappingKey pour ajouter ou supprimer une clé de chiffrement à partir des tables de clés de mappage de clé de l’adaptateur LAN (WLAN) sans fil. Pour plus d’informations sur ces types de clés, consultez 802.11 Types de clés de chiffrement.

Syntaxe

DOT11EXT_SET_KEY_MAPPING_KEY Dot11extSetKeyMappingKey;

DWORD Dot11extSetKeyMappingKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE pKey
)
{...}

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_KEY_MAPPING_KEY_VALUE structure, qui définit la clé de chiffrement.

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

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

Un appel à la fonction Dot11ExtSetKeyMappingKey entraîne une demande définie de la commande OID_DOT11_CIPHER_KEY_MAPPING_KEY identificateur d’objet (OID) au pilote miniport native 802.11 qui gère l’adaptateur WLAN.

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)

Voir aussi

OID_DOT11_CIPHER_KEY_MAPPING_KEY

802.11 Types de clés de chiffrement

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE

Dot11ExtIhvInitAdapter

Partager via