DOT11EXT_SET_DEFAULT_KEY función de devolución de llamada (wlanihv.h)

Artículo
02/07/2025

importante la interfaz Native 802.11 Wireless LAN está en desuso en Windows 10 y versiones posteriores. Use la interfaz de controlador de dispositivo WLAN (WDI) en su lugar. Para obtener más información sobre WDI, consulta modelo de controlador de Windows universal wlan.

El archivo DLL de extensiones de IHV llama a la función dot11ExtSetDefaultKey para agregar o eliminar una clave de cifrado de la clave predeterminada o las tablas de claves predeterminadas por estación del adaptador de LAN inalámbrica (WLAN). Para obtener más información sobre estos tipos de claves, vea 802.11 Tipos de clave de cifrado.

Sintaxis

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

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

Parámetros

[in, optional] hDot11SvcHandle

Identificador utilizado por el sistema operativo para hacer referencia al adaptador WLAN. Este valor de identificador se especificó a través de una llamada anterior a la función de controlador de IHV Dot11ExtIhvInitAdapt er.

[in] pKey

Puntero a un DOT11_CIPHER_DEFAULT_KEY_VALUE estructura, que define la clave de cifrado.

[in] dot11Direction

Valor de DOT11_DIRECTION que especifica si la clave solo se puede usar para paquetes recibidos (DOT11_DIR_INBOUND) o paquetes recibidos y enviados (DOT11_DIR_BOTH).

Nota El archivo DLL de extensiones de IHV no debe pasar un valor de DOT11_DIR_OUTBOUND a este parámetro.

Valor devuelto

Si la llamada se realiza correctamente, la función devuelve ERROR_SUCCESS. De lo contrario, devuelve un código de error definido en Winerror.h.

Observaciones

Una llamada a la función Dot11ExtSetDefaultKey da como resultado una solicitud establecida de OID_DOT11_CIPHER_DEFAULT_KEY identificador de objeto al adaptador WLAN.

Se define una clave de cifrado predeterminada estableciendo el miembro MacAddr del DOT11_CIPHER_DEFAULT_KEY_VALUE estructura en un valor de 0x000000000000. Se define una clave de cifrado predeterminada por estación estableciendo el macAddr miembro en una dirección válida de control de acceso multimedia de unidifusión (MAC).

Se elimina una clave de cifrado de las tablas de claves del adaptador si el bDelete miembro del DOT11_CIPHER_DEFAULT_KEY_VALUE estructura se establece en TRUE.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de	Escritorio
encabezado de	wlanihv.h (incluya Wlanihv.h)