DOT11EXT_PRE_ASSOCIATE_COMPLETION回调函数 (wlanihv.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
IHV 扩展 DLL 调用 Dot11ExtPreAssociateCompletion 函数以异步方式完成通过调用 启动的预关联操作 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。

语法

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

参数

[in, optional] hDot11SvcHandle

操作系统用于引用无线 LAN (WLAN) 适配器的句柄。 此句柄值是通过先前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in, optional] hConnectSession

操作系统用于将连接会话与基本服务集 (BSS) 网络引用的句柄。 此句柄值是通过之前对 的调用指定的 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。

[in] dwReasonCode

一个 值，该值提供预关联操作的完成状态的其他信息。 IHV 扩展 DLL 必须将 dwReasonCode 设置为 L2cmn.h 中定义的L2_REASON_CODE_xxxx值。

IHV 扩展 DLL 通过 dwWin32Error 参数返回预关联操作的常规完成状态。 通常，IHV 扩展 DLL 将 dwReasonCode 设置为从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 范围内的值。

[in] dwWin32Error

由 Winerror.h 中的错误代码定义的预关联操作的完成状态。 如果操作成功完成，IHV 扩展 DLL 必须将 dwWin32Error 设置为 ERROR_SUCCESS。

返回值

如果调用成功，函数将返回ERROR_SUCCESS。 否则，它将返回 Winerror.h 中定义的错误代码。

注解

调用 Dot11ExtPreAssociateCompletion 函数时，IHV 扩展 DLL 必须遵循这些准则。

  • 如果预关联操作成功完成，IHV 扩展 DLL 必须将 dwReasonCode 设置为下列值之一：
    • L2_REASON_CODE_SUCCESS。
    • IHV 定义的值，范围从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在这种情况下，IHV 扩展 DLL 必须将 dwWin32Error 设置为 ERROR_SUCCESS。
  • 如果预关联操作在失败的情况下完成，IHV 扩展 DLL 不得将 dwReasonCode 设置为 L2_REASON_CODE_SUCCESS。 相反，DLL 必须将 dwReasonCode 设置为下列值之一：
    • 适当的L2_REASON_CODE_xxxx错误值。
    • IHV 定义的值，范围从 L2_REASON_CODE_IHV_BASE 到 (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) 。
    在这种情况下，IHV 扩展 DLL 不得将 dwWin32Error 设置为 ERROR_SUCCESS。 相反，DLL 必须将 dwWin32Error 设置为 Winerror.h 中定义的相应错误代码
  • 每当调用 Dot11ExtIhvAdapterReset 或 Dot11ExtIhvDeinitAdapter IHV 处理程序函数时，IHV 扩展 DLL 必须调用 Dot11ExtPreAssociateCompletion 以取消所有挂起的预关联操作。 在这种情况下，DLL 必须将 dwWin32Error 参数设置为 ERROR_CANCELLED。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 wlanihv.h (包括 Wlanihv.h)

另请参阅

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

本机 802.11 IHV 处理程序函数

Dot11ExtIhvPerformPreAssociate