DOT11EXT_SET_DEFAULT_KEY wlanihv.h (回呼函式)
重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。
IHV 延伸模組 DLL 會呼叫 Dot11ExtSetDefaultKey 函式，從無線 LAN (WLAN) 配接器的預設密鑰或每個月台預設密鑰數據表新增或刪除加密密鑰。 如需這些金鑰類型的詳細資訊，請參閱 802.11 加密金鑰類型。
語法
DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;
DWORD Dot11extSetDefaultKey(
[in, optional] HANDLE hDot11SvcHandle,
[in] PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
[in] DOT11_DIRECTION dot11Direction
)
{...}
參數
[in, optional] hDot11SvcHandle
操作系統用來參考WLAN 配接器的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。
[in] pKey
的指標 DOT11_CIPHER_DEFAULT_KEY_VALUE 結構，其定義加密金鑰。
[in] dot11Direction
DOT11_DIRECTION值，指定金鑰只能用於接收的封包 (DOT11_DIR_INBOUND) 或接收和傳送的封包 (DOT11_DIR_BOTH) 。
注意 IHV 延伸模組 DLL 不得將 DOT11_DIR_OUTBOUND 的值傳遞至此參數。
傳回值
如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。
備註
對 Dot11ExtSetDefaultKey 函式的呼叫會導致集合要求 OID_DOT11_CIPHER_DEFAULT_KEY WLAN 配接器的物件標識碼。
預設加密金鑰是藉由設定的 MacAddr 成員來定義 將結構DOT11_CIPHER_DEFAULT_KEY_VALUE 為 0x000000000000的值。 每個月台的預設加密金鑰是藉由將 MacAddr 成員設定為有效的單播媒體存取控制 (MAC) 位址來定義。
如果 的 bDelete 成員，加密金鑰會從配接器的索引鍵數據表中刪除 DOT11_CIPHER_DEFAULT_KEY_VALUE 結構設定為 TRUE。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wlanihv.h (包含 Wlanihv.h) |