關聯前作業指導方針

 

執行預先關聯作業時，IHV 擴充功能 DLL 必須遵循這些指導方針。

• 呼叫 Dot11ExtIhvPerformPreAssociate 函式時，IHV 延伸模組 DLL 必須執行下列動作：

  • 確認連線和安全性設定檔的 IHV 擴充功能。 如果設定檔參數無效， Dot11ExtIhvPerformPreAssociate 函式會傳回適當的錯誤碼，如 Winerror.h 中所定義。
  • 建立並開始新的執行緒，以完成預先關聯作業。 由於預先關聯作業必須從 對 Dot11ExtIhvPerformPreAssociate的呼叫非同步完成，因此 IHV 擴充功能 DLL 必須在作業完成之後從這個執行緒呼叫 Dot11ExtPreAssociateCompletion 。
  • 從函式呼叫傳回ERROR_SUCCESS。 此時，系統會通知作業系統網路設定檔有效，且關聯前作業正在進行中。

• IHV 延伸模組 DLL 可以呼叫 Dot11ExtNicSpecificExtension 函 式，以設定無線區域網路 (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。