DOT11EXT_SET_KEY_MAPPING_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 Dot11ExtSetKeyMappingKey pour ajouter ou supprimer une clé de chiffrement des tables de clés de mappage de clés 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_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 lors d’un appel précédent à la fonction gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] pKey

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

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

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

Un appel à la fonction Dot11ExtSetKeyMappingKey aboutit à une demande de jeu du OID_DOT11_CIPHER_KEY_MAPPING_KEY 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_KEY_MAPPING_KEY

802.11 Types de clés de chiffrement

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE

Dot11ExtIhvInitAdapter

Partager via