DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM fonction de rappel (wlanihv.h)

Article
02/27/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La DLL des extensions IHV appelle la fonction Dot11ExtSetMulticastCipherAlgorithm pour activer un algorithme de chiffrement multidiffusion sur l’adaptateur LAN sans fil (WLAN).

Syntaxe

DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM Dot11extSetMulticastCipherAlgorithm;

DWORD Dot11extSetMulticastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwMulticastCipherAlgo
)
{...}

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 par le biais d’un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] dwMulticastCipherAlgo

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

Si la valeur se trouve dans la plage de DOT11_CIPHER_ALGO_IHV_START via DOT11_CIPHER_ALGO_IHV_END, la DLL 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, via une connexion réseau BSS (Basic Service Set) via la carte WLAN.

Note La valeur de dwMulticastCipherAlgo doit correspondre à la valeur d’un algorithme de chiffrement retourné par le pilote de 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, elle 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 versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (incluez Wlanihv.h)

Voir aussi

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Partager via