функция обратного вызова DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM (wlanihv.h)

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Библиотека DLL расширений IHV вызывает функцию Dot11ExtSetUnicastCipherAlgorithm для включения алгоритма одноадресного шифра в адаптере беспроводной локальной сети (WLAN).

Синтаксис

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

Параметры

[in, optional] hDot11SvcHandle

Дескриптор, используемый операционной системой для ссылки на адаптер WLAN. Это значение дескриптора было указано при предыдущем вызове функции IHV Handler Dot11ExtIhvInitAdapter .

[in] dwUnicastCipherAlgo

Значение перечислителя DOT11_CIPHER_ALGORITHM , идентифицирующее алгоритм одноадресного шифра.

Если значение находится в диапазоне от DOT11_CIPHER_ALGO_IHV_START до DOT11_CIPHER_ALGO_IHV_END, библиотека DLL расширений IHV включает собственный алгоритм шифра, поддерживаемый адаптером WLAN.

В противном случае библиотека DLL отвечает за обработку стандартного алгоритма шифра, поддерживаемого операционной системой. В этом случае операционная система не связана с каким-либо аспектом алгоритма шифра, включая управление ключами и защиту от воспроизведения, через сетевое подключение базового набора служб (BSS) через адаптер WLAN.

Примечание Значение dwUnicastCipherAlgo должно соответствовать значению алгоритма шифра, возвращаемого драйвером мини-порта native 802.11 путем задания соответствующих элементов XxxAlgoPairsструктуры DOT11_EXTSTA_ATTRIBUTES , которые должны соответствовать значениям, возвращаемым запросами OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR или OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Возвращаемое значение

Если вызов завершается успешно, функция возвращает ERROR_SUCCESS. В противном случае возвращается код ошибки, определенный в Winerror.h.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wlanihv.h (включая Wlanihv.h)

См. также раздел

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter