通过

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 处理程序函数指定的。

[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