ServiceBase.OnSessionChange Method

Note: This method is new in the .NET Framework version 2.0.

Executes when a change event is received from a Terminal Server session.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

'Declaration
Protected Overridable Sub OnSessionChange ( _
	changeDescription As SessionChangeDescription _
)
'Usage
Dim changeDescription As SessionChangeDescription

Me.OnSessionChange(changeDescription)
protected void OnSessionChange (
	SessionChangeDescription changeDescription
)
protected function OnSessionChange (
	changeDescription : SessionChangeDescription
)

Parameters

changeDescription

A SessionChangeDescription structure that identifies the change type.

The following code example shows an implementation of the OnSessionChange method in a class derived from ServiceBase. This code example is part of a larger example provided for the ServiceBase class.

    ' Handle a session change notice
    Protected Overrides Sub OnSessionChange(ByVal changeDescription As SessionChangeDescription)
#If LOGEVENTS Then
        System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
        DateTime.Now.ToLongTimeString() + " - Session change notice recieved: " + _
        changeDescription.Reason.ToString() + "  Session ID: " + _
        changeDescription.SessionId.ToString())
#End If

        Select Case changeDescription.Reason
            Case SessionChangeReason.SessionLogon
                userCount += 1
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " SessionLogon, total users: " + _
                userCount.ToString())
#End If

            Case SessionChangeReason.SessionLogoff

                userCount -= 1
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " SessionLogoff, total users: " + _
                userCount.ToString())
#End If
            Case SessionChangeReason.RemoteConnect
                userCount += 1
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " RemoteConnect, total users: " + _
                userCount.ToString())
#End If

            Case SessionChangeReason.RemoteDisconnect

                userCount -= 1
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " RemoteDisconnect, total users: " + _
                userCount.ToString())
#End If
            Case SessionChangeReason.SessionLock
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " SessionLock")
#End If

            Case SessionChangeReason.SessionUnlock
#If LOGEVENTS Then
                System.Diagnostics.EventLog.WriteEntry("SimpleService.OnSessionChange", _
                DateTime.Now.ToLongTimeString() + " SessionUnlock")
#End If

            Case Else
        End Select

    End Sub 'OnSessionChange


  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: