DOT11EXTIHV_PERFORM_PRE_ASSOCIATE回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型
 
操作系统调用 Dot11ExtIhvPerformPreAssociate 函数,请求 IHV 扩展 DLL 启动与基本服务集的预关联操作, (BSS) 网络。

语法

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

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

参数

[in, optional] hIhvExtAdapter

IHV 扩展 DLL 用来引用无线 LAN (WLAN) 适配器的句柄。 此句柄值是通过对 Dot11ExtIhvInitAdapter IHV 处理程序函数的上一次调用指定的。

[in, optional] hConnectSession

操作系统用来引用与基本服务集的连接会话的句柄 (BSS) 网络。

[in, optional] pIhvProfileParams

指向 DOT11EXT_IHV_PROFILE_PARAMS 结构。 此结构定义将应用配置文件扩展 (BSS) 网络的基本服务集的属性。

[in] pIhvConnProfile

指向 DOT11EXT_IHV_CONNECTIVITY_PROFILE 包含 IHV 配置文件的连接设置的结构。

[in] pIhvSecProfile

指向 DOT11EXT_IHV_SECURITY_PROFILE 结构,指定 IHV 配置文件的安全设置。

[in] pConnectableBssid

指向 DOT11_BSS_LIST 结构的指针,该结构包含一个或多个 802.11 信标或探测响应帧,用于服务集标识符 (SSID) BSS 网络,DLL 将对其执行关联前操作。

[out] pdwReasonCode

指向 DWORD 值的指针,它为 Dot11ExtIhvPerformPreAssociate 函数的返回值提供其他信息。 IHV 扩展 DLL 必须将 * pdwReasonCode 设置为在 L2cmn.h 中定义的L2_REASON_CODE_xxxx值。

返回值

如果 IHV 扩展 DLL 可以启动预关联操作,则必须异步完成该操作。 在这种情况下,函数将返回ERROR_SUCCESS。

如果 IHV 扩展 DLL 无法启动预关联操作,它将返回 在 Winerror.h 中定义的错误代码。

备注

操作系统调用 Dot11ExtIhvPerformPreAssociate 函数,以启动与 IHV 扩展 DLL 的预关联操作。 操作系统在通过 WLAN 适配器启动与基本服务集 (BSS) 网络的连接操作之前启动此操作。 有关连接操作的详细信息,请参阅 连接操作

必须从对 Dot11ExtIhvPerformPreAssociate 的调用异步完成预关联操作。 关联前操作完成后,IHV 扩展 DLL 必须调用 Dot11ExtPreAssociateCompletion

调用 Dot11ExtIhvPerformPreAssociate 函数时,IHV 扩展 DLL 必须遵循以下准则。

  • 如果 IHV 扩展 DLL 可以启动预关联操作, Dot11ExtIhvPerformPreAssociate 函数必须返回ERROR_SUCCESS并异步完成操作。
  • IHV 扩展 DLL 提供有关通过 pdwReasonCode 参数启动预关联操作的详细信息。 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 定义值,无论是否可以启动预关联操作。
有关关联前操作的详细信息,请参阅 关联前操作

要求

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

另请参阅

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

Dot11ExtPreAssociateCompletion

OID_DOT11_CONNECT_REQUEST

本机 802.11 IHV 可扩展性函数

DOT11EXT_IHV_PROFILE_PARAMS