DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM funzione di callback (wlanihv.h)

Articolo
02/07/2025

importante L'interfaccia LAN wireless 802.1 1 nativa è 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 di Windows universale WLAN.

La DLL delle estensioni IHV chiama la funzione Dot11ExtSetUnicastCipherAlgorithm per abilitare un algoritmo di crittografia unicast sulla scheda LAN wireless (WLAN).

Sintassi

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

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

Parametri

[in, optional] hDot11SvcHandle

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

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

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 questo caso, il sistema operativo non è coinvolto in alcun aspetto dell'algoritmo di crittografia, inclusa la gestione delle chiavi e la protezione della riproduzione, tramite una connessione di rete BSS (Basic Service Set) tramite la scheda WLAN.

Nota Il valore di dwUnicastCipherAlgo deve corrispondere al valore di un algoritmo di crittografia restituito dal driver miniport nativo 802.11 tramite l'impostazione del xxxAlgoPairs membri 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.

Fabbisogno

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)

Vedere anche

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Condividi tramite