DOT11EXT_SET_CURRENT_PROFILE回呼函式 (wlanihv.h)
重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。
語法
DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;
DWORD Dot11extSetCurrentProfile(
[in, optional] HANDLE hDot11SvcHandle,
[in, optional] HANDLE hConnectSession,
[in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
[in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}
參數
[in, optional] hDot11SvcHandle
操作系統用來參考無線 LAN (WLAN) 適配卡的句柄。 這個句柄值是透過 先前呼叫 Dot11ExtIhvInitAdapter IHV Handler 函式來指定。
[in, optional] hConnectSession
操作系統用來參考聯機會話與基本服務集的句柄， (BSS) 網路。 這個句柄值是透過先前對的呼叫所指定 Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。
[in, optional] pIhvConnProfile
的指標 DOT11EXT_IHV_CONNECTIVITY_PROFILE 結構，其中包含IHV配置檔的連線設定。
[in, optional] pIhvSecProfile
的指標 DOT11EXT_IHV_SECURITY_PROFILE 結構，指定 IHV 設定檔的安全性設定。
傳回值
如果呼叫成功，函式會傳回ERROR_SUCCESS。 否則，它會傳回 Winerror.h 中定義的錯誤碼。
備註
Dot11ExtSetCurrentProfile 函式可讓 IHV 將自定義連線和安全性配置檔片段新增至用於基本服務集的目前網路配置檔， (BSS) 網路連線。 配置檔片段是 IHV 特有的，適用於透過 原生 802.11 IHV UI 延伸模組 DLL 提供給使用者的連線或安全性延伸模組。
呼叫 Dot11ExtSetCurrentProfile 函式時，IHV 延伸模組 DLL 必須遵循下列指導方針：
- IHV 延伸模組 DLL 只有在執行透過 呼叫起始的關聯前作業時，才能呼叫 Dot11ExtSetCurrentProfile Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。 如需預先關聯作業的詳細資訊，請參閱 關聯前作業。
- IHV 延伸模組 DLL 不得從對 的呼叫內呼叫 Dot11ExtSetCurrentProfile Dot11ExtIhvPerformPreAssociate IHV 處理程式函式。 Dot11ExtSetCurrentProfile 必須從與處理 Dot11ExtIhvPerformPreAssociate 呼叫不同的線程呼叫。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wlanihv.h (包含 Wlanihv.h) |