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

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 via 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 multidiffusion.

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

Sinon, la DLL est chargée de traiter 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.

Remarque La valeur de dwMulticastCipherAlgo doit correspondre à la valeur d’un algorithme de chiffrement retourné par le pilote miniport Native 802.11 en définissant les xxxAlgoPairs membres de la structure DOT11_EXTSTA_ATTRIBUTES, qui doivent correspondre aux valeurs retournées par les requêtes de OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou de OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

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.

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

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Partager via