通过

DOT11EXTIHV_QUERY_UI_REQUEST回调函数 （wlanihv.h）

  • 项目
重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 WLAN 设备驱动程序接口（WDI）。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
每当连接状态更改时，作系统将调用 Dot11ExtIhvQueryUIRequest 函数。 调用此函数时，IHV 扩展 DLL 将返回作系统可用于 UI 请求的 DOT11EXT_IHV_UI_REQUEST 结构。

语法

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

参数

[in, optional] hIhvExtAdapter

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

[in] connectionPhase

当前连接阶段。 此成员的数据类型是 DOT11EXT_IHV_CONNECTION_PHASE 枚举：

connection_phase_any

指定任何连接阶段。

connection_phase_initial_connection

指定 IHV 扩展 DLL 启动预关联作之前的连接阶段。 有关关联前作的详细信息，请参阅 关联前作。

connection_phase_post_l3_connection

指定 IHV 扩展 DLL 完成关联后作后的连接阶段。 有关关联后作的详细信息，请参阅 关联后作。

[out] ppIhvUIRequest

指向 DOT11EXT_IHV_UI_REQUEST 结构的指针的地址。 IHV 扩展 DLL 必须通过调用 dot11ExtAllocateBuffer 为DOT11EXT_IHV_UI_REQUEST结构分配缓冲区。

返回值

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

言论

调用 dot11ExtIhvQueryUIRequest 时，IHV 扩展 DLL 必须分配并返回格式化为 DOT11EXT_IHV_UI_REQUEST 结构的缓冲区。 在这种情况下，DLL 必须遵循以下准则：

  • IHV 扩展 DLL 必须调用 Dot11ExtAllocateBuffer 来分配缓冲区。 DLL 从 Dot11ExtIhvQueryUIRequest返回后，作系统负责调用 Dot11ExtFreeBuffer 释放缓冲区。
  • IHV 扩展 DLL 为适合连接状态更改的 UI 请求设置 DOT11EXT_IHV_UI_REQUEST 结构的格式。

    例如，如果 connectionPhase 设置为 connection_phase_initial_connection，IHV 扩展 DLL 可以设置DOT11EXT_IHV_UI_REQUEST结构的成员来引用通知用户启动连接作的用户界面页。

要求

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

另请参阅

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer