fonction de rappel DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM (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 Dot11ExtSetUnicastCipherAlgorithm pour activer un algorithme de chiffrement unicast sur l’adaptateur LAN sans fil (WLAN).

Syntaxe

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

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

Valeur d’énumérateur DOT11_CIPHER_ALGORITHM qui identifie l’algorithme de chiffrement unicast.

Si la valeur se trouve dans la plage de DOT11_CIPHER_ALGO_IHV_START via DOT11_CIPHER_ALGO_IHV_END, la DLL des extensions IHV active un algorithme de chiffrement propriétaire pris en charge par l’adaptateur WLAN.

Sinon, la DLL est responsable du traitement d’un algorithme de chiffrement standard pris en charge par le système d’exploitation. Dans ce cas, le système d’exploitation n’est impliqué dans aucun aspect de l’algorithme de chiffrement, y compris la gestion des clés et la protection contre la relecture, sur une connexion réseau BSS (Basic Service Set) via la carte WLAN.

Note La valeur de dwUnicastCipherAlgo doit correspondre à la valeur d’un algorithme de chiffrement retourné par le pilote miniport native 802.11 en définissant les xxx membres AlgoPairs appropriés de la structure DOT11_EXTSTA_ATTRIBUTES, qui doivent correspondre aux valeurs qui seraient retournées par les requêtes de OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou de OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

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.

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_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Partager via