Share via

Dot11ExtIhvIsUIRequestPending (Compact 7)

  • Article

3/12/2014

The operating system calls this function to query the status of a UI request initiated by the IHV Extensions DLL.

Syntax

DWORD WINAPI Dot11ExtIhvIsUIRequestPending(
    GUID guidUIRequest,
    PBOOL pbIsRequestPending
);

Parameters

  • guidUIRequest
    [in] The GUID that identifies the request. This GUID value was created by the IHV Extensions DLL and passed through the pIhvUIRequest parameter of the call to Dot11ExtSendUIRequest.
  • pbIsRequestPending
    [out] A pointer to a Boolean value. If the UI request, identified by the guidUIRequest parameter, is pending, the IHV Extensions DLL must set *pbIsRequestPending to TRUE.

Return Value

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

Remarks

The IHV Extensions DLL can issue requests to the IHV UI Extensions DLL to interact with the user. Examples of such requests are the display of notifications during the pre-association operation or the input of credentials for the post-association operation. For more information about the IHV UI Extensions DLL, see Native 802.11 IHV UI Extensions DLLffc6c041-8e02-4955-9efe-a7e38f5d8623.

The IHV Extensions DLL starts these requests for user interaction through calls to the Dot11ExtSendUIRequest function. For each UI request, the DLL must format a DOT11EXT_IHV_UI_REQUESTb1bab4a7-627c-4400-8d64-0f09ab368062 structure to define the request, and must set the guidUIRequest member of this structure to a GUID value that uniquely identifies the UI request. The IHV Extensions DLL passes the address of the DOT11EXT_IHV_UI_REQUEST structure through the pIhvUIRequest parameter of the Dot11ExtSendUIRequest function.

The operating system can periodically call the Dot11ExtIhvIsUIRequestPending98afbb0c-0dd0-471f-ad5b-c40591131e89 function to query the status of the UI request as identified by the guidUIRequest parameter. If the UI request is still pending, the IHV Extensions DLL must set *pbIsRequestPending to TRUE. Otherwise, the DLL must set *pbIsRequestPending to FALSE.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtSendUIRequest
DOT11EXT_IHV_UI_REQUEST
Dot11ExtIhvIsUIRequestPending
Native 802.11 IHV Extensions DLL