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

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 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 de controlador de IHV Dot11ExtIhvInitAdapt er.

[in] uDefaultKeyId

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

Para los algoritmos de cifrado estándar 802.11, como WEP o TKIP, uDefaultKeyId debe ser de 0 a 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.

Observaciones

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 el adaptador usa 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 miniport nativo 802.11, que administra el adaptador WLAN.

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)

Consulte también

OID_DOT11_CIPHER_DEFAULT_KEY_ID

dot11ExtIhvInitAdapter

802.11 Tipos de clave de cifrado

  • Last updated on