關聯前作業指導方針
執行預先關聯作業時,IHV 延伸模組 DLL 必須遵循這些指導方針。
呼叫 Dot11ExtIhvPerformPreAssociate 函式時,IHV 延伸模組 DLL 必須執行下列動作:
- 確認 IHV 擴充功能對連接性和安全性配置檔的影響。 如果設定檔參數無效,Dot11ExtIhvPerformPreAssociate 函式會傳回 Winerror.h 中定義的適當錯誤碼。
- 建立並開始新的線程,以完成預先關聯作業。 由於預先關聯作業必須從呼叫 Dot11ExtIhvPerformPreAssociate異步完成,因此 IHV 延伸模組 DLL 必須在作業完成之後從這個線程呼叫 Dot11ExtPreAssociateCompletion。
- 從函式呼叫傳回 ERROR_SUCCESS。 此時,操作系統被通知網路設定檔有效,並且預關聯程序正在進行中。
IHV 延伸模組 DLL 可以呼叫 Dot11ExtNicSpecificExtension 函式來設定無線 LAN (WLAN) 適配卡。 此函式可以從 Dot11ExtIhvPerformPreAssociate 的呼叫內部呼叫,也可以從處理預先關聯操作的線程,在 Dot11ExtIhvPerformPreAssociate 傳回後呼叫。
呼叫 Dot11ExtSetProfileCustomUserData、Dot11ExtGetProfileCustomUserData,且 Dot11ExtSetCurrentProfile,不得從呼叫 Dot11ExtIhvPerformPreAssociate進行。 這些函式只能在 Dot11ExtIhvPerformPreAssociate 傳回「ERROR_SUCCESS」之後呼叫。
在 IHV 延伸模組 DLL 呼叫 Dot11ExtPreAssociateCompletion 以完成預先關聯作業之後,連線會話的句柄將不再有效的。 作業系統會透過 Dot11ExtIhvPerformPreAssociate的 hConnectSession 參數傳遞此操作代碼。 呼叫任何宣告 hConnectSession 參數的 IHV 擴充性函式時,DLL 不得使用此句柄值。
如需 IHV 擴充性函式的詳細資訊,請參閱 Native 802.11 IHV 擴充性函式。
如果呼叫 Dot11ExtIhvAdapterReset 函式,IHV 延伸模組 DLL 必須呼叫 Dot11ExtPreAssociateCompletion來取消預先關聯作業。 如需重設作業的詳細資訊,請參閱 802.11 WLAN 配接器重設。
如果呼叫 Dot11ExtIhvDeinitAdapter 函式,IHV 延伸模組 DLL 必須在內部取消預先關聯作業。 不過,它不得呼叫只能在配接器初始化之後呼叫的任何 IHV 擴充性函式,包括 Dot11ExtPreAssociateCompletion。