共用方式為

DOT11EXTIHV_VALIDATE_PROFILE回呼函式 （wlanihv.h）

  • 發行項
重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。 請改用 WLAN 裝置驅動器介面 （WDI）。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。
 
作系統會呼叫 Dot11ExtIhvValidateProfile 函式，以驗證為網路配置檔輸入的用戶數據。 IHV 延伸模組 DLL 只負責驗證 IHV 所定義之連線和安全性配置檔片段的數據。

語法

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [out]          PDWORD pdwReasonCode
)
{...}

參數

[in, optional] hIhvExtAdapter

IHV 延伸模組 DLL 用來參考無線 LAN （WLAN） 適配卡的句柄。 這個句柄值是透過先前呼叫 dot11ExtIhvInitAdapter IHV Handler 函式來指定。

[in, optional] pIhvProfileParams

的指標 DOT11EXT_IHV_PROFILE_PARAMS 結構。 此結構會定義將套用配置檔擴充功能之基本服務集 （BSS） 網路的屬性。

[in] pIhvConnProfile

的指標 DOT11EXT_IHV_CONNECTIVITY_PROFILE 結構，其中包含 IHV 配置檔的連線設定。

[in] pIhvSecProfile

的指標 DOT11EXT_IHV_SECURITY_PROFILE 結構，其中包含IHV配置檔的安全性設定。

[out] pdwReasonCode

DWORD 值的指標，提供 Dot11ExtIhvValidateProfile 函式傳回值的其他資訊。 IHV 延伸模組 DLL 必須將 * pdwReasonCode 設定為 L2cmn.h 中定義的L2_REASON_CODE_xxxx值。

傳回值

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

言論

作系統會呼叫 Dot11ExtIhvValidateProfile 函式，在處理或儲存配置檔之前驗證網路配置檔的使用者指定設定。

呼叫 Dot11ExtIhvValidateProfile 函式時，IHV 延伸模組 DLL 會遵循下列指導方針：

  • IHV 延伸模組 DLL 會驗證使用者指定的設定檔設定是否適用於將套用配置檔之基本服務集 （BSS） 網路的一般屬性。 BSS 網路屬性是透過 pIhvProfileParams 參數來參考。
  • 如果用戶數據對網路配置檔延伸模組有效，Dot11ExtIhvValidateProfile 必須傳回ERROR_SUCCESS。 否則，函式必須從 Winerror.h 中定義的ERROR_xxxx值傳回適當的錯誤碼。
  • IHV 延伸模組 DLL 提供有關使用者數據驗證結果的詳細資訊。 DLL 必須將 * pdwReasonCode 設為下列其中一項：
    • L2_REASON_CODE_SUCCESS，如果用戶數據有效。
    • 如果使用者數據無效，則為適當的L2_REASON_CODE_xxxx錯誤值。
    • 從 L2_REASON_CODE_IHV_BASE 到 （L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1） 範圍內的 IHV 定義值，不論用戶數據的有效性為何。
如需 Native 802.11 XML 架構的詳細資訊，請參閱 Microsoft Windows SDK 檔。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 桌面
標頭 wlanihv.h （包括 Wlanihv.h、L2cmn.h）

另請參閱

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE