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

Artículo
03/05/2024

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

El archivo DLL de extensiones IHV llama a la función Dot11ExtSetDefaultKey para agregar o eliminar una clave de cifrado de la clave predeterminada o de 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 clave, 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 Dot11ExtIhvInitAdapter IHV Handler.

[in] pKey

Puntero a 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 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.

Comentarios

Una llamada a la función Dot11ExtSetDefaultKey da como resultado una solicitud set 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 miembro MacAddr 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 miembro bDelete del DOT11_CIPHER_DEFAULT_KEY_VALUE estructura se establece en TRUE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	wlanihv.h (incluye Wlanihv.h)