DOT11EXT_SET_DEFAULT_KEY_ID 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 Dot11ExtSetDefaultKeyId per impostare l'indice di tabella della chiave di crittografia predefinita o per stazione con cui la scheda LAN wireless (WLAN) utilizza per impostazione predefinita durante la crittografia dei dati dei pacchetti trasmessi.

Sintassi

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

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] uDefaultKeyId

Valore di indice della chiave all'interno delle tabelle chiave di crittografia predefinite o per stazione dell'adattatore.

Per gli algoritmi di crittografia standard 802.11, ad esempio WEP o TKIP, uDefaultKeyId deve essere compreso tra 0 e 3. Per un algoritmo di crittografia proprietario sviluppato da un IHV, uDefaultKeyId può essere qualsiasi valore all'interno dell'intervallo definito dall'IHV.

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

L'identificatore di chiave predefinito (ID) specifica l'indice di una chiave di crittografia nella chiave predefinita dell'adattatore e nelle tabelle chiave predefinite per stazione utilizzate dall'adattatore per la crittografia dei dati. L'adattatore usa la chiave di crittografia a cui fa riferimento l'ID chiave predefinito come chiave di crittografia predefinita per i pacchetti trasmessi, a meno che non esista una chiave di mapping delle chiavi per l'indirizzo MAC (Media Access Control) di destinazione. Per altre informazioni su questi tipi di chiave di crittografia, vedere 802.11 Tipi di chiave di crittografia.

Una chiamata alla funzione Dot11ExtSetDefaultKeyId genera una richiesta set di OID_DOT11_CIPHER_DEFAULT_KEY_ID identificatore di oggetto (OID) al driver miniport nativo 802.11, che gestisce l'adattatore WLAN.

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_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

Tipi di chiave di crittografia 802.11

Condividi tramite