DOT11EXTIHV_PROCESS_SESSION_CHANGE callback function (wlanihv.h)

Article
10/21/2021

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 Dot11ExtIhvProcessSessionChange function to notify the IHV Extensions DLL of a session change event.

Syntax

DOT11EXTIHV_PROCESS_SESSION_CHANGE Dot11extihvProcessSessionChange;

DWORD Dot11extihvProcessSessionChange(
  [in] ULONG uEventType,
  [in] PWTSSESSION_NOTIFICATION pSessionNotification
)
{...}

Parameters

[in] uEventType

The type of event. This parameter can have one of the following values.

Value	Meaning
WTS_CONSOLE_CONNECT	A session was connected to the console session.
WTS_CONSOLE_DISCONNECT	A session was disconnected from the console session.
WTS_REMOTE_CONNECT	A session was connected to the remote session.
WTS_REMOTE_DISCONNECT	A session was disconnected from the remote session.
WTS_SESSION_LOGON	A user has logged on to the session.
WTS_SESSION_LOGOFF	A user has logged off of the session.
WTS_SESSION_LOCK	A session has been locked.
WTS_SESSION_UNLOCK	A session has been unlocked.
WTS_SESSION_REMOTE_CONTROL	A session has changed its remote controlled status. To determine the status, call the GetSystemMetrics function and check the SM_REMOTECONTROL metric. For more information about this function, refer to the Microsoft Windows SDK documentation.

[in] pSessionNotification

A pointer to a WTSSESSION_NOTIFICATION structure, which provides information about the session change notification. For more information about this structure, refer to the Windows SDK documentation.

Return value

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

Remarks

The operating system calls the function to notify the IHV Extensions DLL whenever a switch in a user session occurs.

If the uEventType parameter is set to WTS_SESSION_LOGOFF, the IHV Extensions DLL must cancel all pending user interface requests internally and must release any allocated resources for the user interface requests.

Requirements

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