DOT11EXT_SET_DEFAULT_KEY funzione di callback (wlanihv.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless native 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 delle estensioni IHV chiama la funzione Dot11ExtSetDefaultKey per aggiungere o eliminare una chiave di crittografia dalle tabelle chiave predefinite o predefinite per stazione della scheda LAN wireless (WLAN). Per altre informazioni su questi tipi di chiave, vedere 802.11 Tipi di chiave di crittografia.

Sintassi

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

Parametri

[in, optional] hDot11SvcHandle

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

[in] pKey

Puntatore a DOT11_CIPHER_DEFAULT_KEY_VALUE struttura, che definisce la chiave di crittografia.

[in] dot11Direction

Valore DOT11_DIRECTION che specifica se la chiave può essere usata solo per i pacchetti ricevuti (DOT11_DIR_INBOUND) o per i pacchetti ricevuti e inviati (DOT11_DIR_BOTH).

Nota La DLL delle estensioni IHV non deve passare un valore di DOT11_DIR_OUTBOUND a questo parametro.

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.

Commenti

Una chiamata alla funzione Dot11ExtSetDefaultKey genera una richiesta set di OID_DOT11_CIPHER_DEFAULT_KEY identificatore dell'oggetto per l'adattatore WLAN.

Una chiave di crittografia predefinita viene definita impostando il membro MacAddr del DOT11_CIPHER_DEFAULT_KEY_VALUE struttura a un valore di 0x000000000000. Una chiave di crittografia predefinita per stazione viene definita impostando il membro MacAddr su un indirizzo MAC (Media Access Control) unicast valido.

Una chiave di crittografia viene eliminata dalle tabelle chiave dell'adattatore se il membro bDelete dell'oggetto DOT11_CIPHER_DEFAULT_KEY_VALUE struttura è impostata su TRUE.

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)