DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM wlanihv.h) DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM 回呼 (函式
重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型。
IHV 擴充功能 DLL 會呼叫 Dot11ExtSetUnicastCipherAlgorithm 函式,以在無線 LAN (WLAN) 適配卡上啟用單播加密演算法。
語法
DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;
DWORD Dot11extSetUnicastCipherAlgorithm(
[in, optional] HANDLE hDot11SvcHandle,
[in] DWORD dwUnicastCipherAlgo
)
{...}
參數
[in, optional] hDot11SvcHandle
操作系統用來參考WLAN 配接器的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式所指定。
[in] dwUnicastCipherAlgo
識別單播加密演算法 的DOT11_CIPHER_ALGORITHM 列舉值。
如果值在透過 DOT11_CIPHER_ALGO_IHV_END DOT11_CIPHER_ALGO_IHV_START 範圍內,IHV 擴充功能 DLL 會啟用WLAN 配接器支援的專屬加密演算法。
否則,DLL 會負責處理操作系統所支援的標準加密演算法。 在此情況下,操作系統不會涉及任何加密演算法層面,包括密鑰管理和重新執行保護,透過 WLAN 適配卡 (BSS) 網路連線的基本服務集。
注意dwUnicastCipherAlgo 的值必須符合 Native 802.11 迷你埠驅動程式所傳回的加密演算法值,方法是設定DOT11_EXTSTA_ATTRIBUTES結構的適當 xxxAlgoPairs 成員,這必須符合查詢OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR或OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR所傳回的值。
傳回值
如果呼叫成功,函式會傳回ERROR_SUCCESS。 否則,它會傳回 Winerror.h 中定義的錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | 桌面 |
標頭 | wlanihv.h (包含 Wlanihv.h) |