DOT11EXTIHV_QUERY_UI_REQUEST callback function

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
The operating system calls the Dot11ExtIhvQueryUIRequest function whenever the connection status changes. When this function is called, the IHV Extensions DLL returns a DOT11EXT_IHV_UI_REQUEST structure that the operating system can use for a UI request.


DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  HANDLE hIhvExtAdapter,



The handle used by the IHV Extensions DLL to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.


The current connection phase. The data type for this member is the DOT11EXT_IHV_CONNECTION_PHASE enumeration:


Specifies any connection phase.


Specifies the connection phase before the IHV Extensions DLL initiates a pre-association operation. For more information about the pre-association operation, see Pre-Association Operations.


Specifies the connection phase after the IHV Extensions DLL completes a post-association operation. For more information about the post-association operation, see Post-Association Operations.


Return value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.


When Dot11ExtIhvQueryUIRequest is called, the IHV Extensions DLL must allocate and return a buffer formatted as a DOT11EXT_IHV_UI_REQUEST structure. In this situation, the DLL must follow these guidelines:

  • The IHV Extensions DLL must call Dot11ExtAllocateBuffer to allocate the buffer. After the DLL returns from Dot11ExtIhvQueryUIRequest, the operating system is responsible for calling Dot11ExtFreeBuffer to free the buffer.
  • The IHV Extensions DLL formats the DOT11EXT_IHV_UI_REQUEST structure for a UI request appropriate for the change in connection status.

    For example, if connectionPhase is set to connection_phase_initial_connection, the IHV Extensions DLL could set the members of the DOT11EXT_IHV_UI_REQUEST structure to reference a user interface page that notifies the user of the start of the connection operation.


Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header wlanihv.h (include Wlanihv.h)

See also