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

  • Artículo
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 dispositivos WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador universal de Windows WLAN.
 
El archivo DLL de extensiones de IHV llama a la función Dot11ExtSetDefaultKeyId para establecer el índice de tabla de la clave de cifrado predeterminada o por estación con la que el adaptador de LAN inalámbrico (WLAN) usa de forma predeterminada al cifrar los datos de paquetes transmitidos.

Sintaxis

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

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

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

Valor de índice de la clave dentro de las tablas de claves de cifrado predeterminadas o por estación del adaptador.

Para los algoritmos de cifrado estándar 802.11, como WEP o TKIP, uDefaultKeyId debe estar comprendido entre 0 y 3. Para un algoritmo de cifrado propietario desarrollado por un IHV, uDefaultKeyId puede ser cualquier valor dentro del intervalo definido por el IHV.

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

El identificador de clave predeterminado (ID) especifica el índice de una clave de cifrado en la clave predeterminada del adaptador y las tablas de claves predeterminadas por estación que usa el adaptador para el cifrado de datos. El adaptador usa la clave de cifrado a la que hace referencia el identificador de clave predeterminado como clave de cifrado predeterminada para los paquetes transmitidos a menos que exista una clave de asignación de claves para la dirección de control de acceso multimedia (MAC) de destino. Para obtener más información sobre estos tipos de clave de cifrado, vea 802.11 Tipos de clave de cifrado.

Una llamada a la función Dot11ExtSetDefaultKeyId da como resultado una solicitud establecida de . OID_DOT11_CIPHER_DEFAULT_KEY_ID identificador de objeto (OID) al controlador de minipuerto Native 802.11, que administra el adaptador WLAN.

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 (incluya Wlanihv.h)

Consulte también

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 Tipos de clave de cifrado