Share via

Dot11ExtIhvProcessUIResponse (Compact 2013)

  • Article

3/26/2014

The operating system calls this function to complete a UI request initiated by the IHV Extensions DLL through a call to Dot11ExtSendUIRequest.

Syntax

DWORD WINAPI Dot11ExtIhvProcessUIResponse(
    GUID guidUIRequest,
    DWORD dwByteCount,
    LPVOID pvResponseBuffer
);

Parameters

  • guidUIRequest
    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.
  • dwByteCount
    The length, in bytes, of the data referenced through the pvResponseBuffer parameter.
  • pvResponseBuffer
    A pointer to the buffer that contains the user data.

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 for interaction with the user, such as the display of notifications during the pre-association operation or the input of credential 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 DLL passes the address of the DOT11EXT_IHV_UI_REQUEST structure through the pIhvUIRequest parameter of the Dot11ExtSendUIRequest function.

After it receives this data from the IHV Extensions DLL, the operating system calls the Dot11ExtIhvProcessUIResponse function to process the user response. This is referenced through the pvResponseBuffer parameter. The response data is in a format that is defined by the IHV and has been validated by the IHV UI Extensions DLL.

Requirements

Header

wlanihv.h

See Also

Reference

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