DOT11EXT_SET_DEFAULT_KEY_ID回呼函式 (wlanihv.h)

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

 

IHV 延伸模組 DLL 會呼叫 Dot11ExtSetDefaultKeyId 函式，以設定無線 LAN (WLAN) 配接器在加密傳輸封包數據時預設使用的每一月臺加密密鑰的數據表索引。

語法

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

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

參數

[in, optional] hDot11SvcHandle

操作系統用來參考WLAN 配接器的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。

[in] uDefaultKeyId

配接器預設或每站加密索引鍵數據表內索引鍵的索引值。

針對標準 802.11 加密演算法，例如 WEP 或 TKIP，uDefaultKeyId 必須介於 0 到 3。 針對 IHV 所開發的專屬加密演算法， uDefaultKeyId 可以是 IHV 所定義範圍內的任何值。

傳回值

如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。

備註

預設金鑰識別碼 (識別子) 指定配卡預設密鑰和配接器用於數據加密的每個月台預設金鑰資料表中加密金鑰的索引。 除非目的地媒體訪問控制 (MAC) 位址存在金鑰對應金鑰，否則配接器會使用預設金鑰標識碼所參考的加密金鑰作為傳輸封包的預設加密金鑰。 如需這些加密金鑰類型的詳細資訊，請參閱 802.11 加密金鑰類型。

呼叫 Dot11ExtSetDefaultKeyId 函式會導致集合要求 OID_DOT11_CIPHER_DEFAULT_KEY_ID 對象標識碼 (OID) 至管理 WLAN 適配卡的 Native 802.11 迷你埠驅動程式。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	wlanihv.h (包含 Wlanihv.h)

另請參閱

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 加密金鑰類型