DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM funzione di callback (wlanihv.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

La DLL di estensioni IHV chiama la funzione Dot11ExtSetMulticastCipherAlgorithm per abilitare un algoritmo di crittografia multicast nella scheda LAN wireless (WLAN).

Sintassi

DOT11EXT_SET_MULTICAST_CIPHER_ALGORITHM Dot11extSetMulticastCipherAlgorithm;

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

Parametri

[in, optional] hDot11SvcHandle

Handle usato dal sistema operativo per fare riferimento all'adattatore WLAN. Questo valore di handle è stato specificato tramite una chiamata precedente alla funzione Dot11ExtIhvInitAdapter IHV Handler.

[in] dwMulticastCipherAlgo

Valore dell'enumeratore DOT11_CIPHER_ALGORITHM che identifica l'algoritmo di crittografia multicast.

Se il valore è compreso nell'intervallo di DOT11_CIPHER_ALGO_IHV_START tramite DOT11_CIPHER_ALGO_IHV_END , la DLL delle estensioni IHV abilita un algoritmo di crittografia proprietario supportato dalla scheda WLAN.

In caso contrario, la DLL è responsabile dell'elaborazione di un algoritmo di crittografia standard supportato dal sistema operativo. In questa situazione, il sistema operativo non è coinvolto in alcun aspetto dell'algoritmo di crittografia, inclusa la gestione delle chiavi e la protezione di riproduzione, tramite una connessione di rete BSS (Basic Service Set) tramite la scheda WLAN.

Nota Il valore dwMulticastCipherAlgo deve corrispondere al valore di un algoritmo di crittografia restituito dal driver miniport nativo 802.11 impostando i membri appropriati diAlgoPairs della struttura DOT11_EXTSTA_ATTRIBUTES , che deve corrispondere ai valori restituiti dalle query di OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR o OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Valore restituito

Se la chiamata ha esito positivo, la funzione restituisce ERROR_SUCCESS. In caso contrario, restituisce un codice di errore definito in Winerror.h.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	wlanihv.h (include Wlanihv.h)

Vedi anche

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter