Export (0) Print
Expand All

SystemEvents.SessionEnding Event

Occurs when the user is trying to log off or shut down the system.

Namespace: Microsoft.Win32
Assembly: System (in system.dll)

public:
static event SessionEndingEventHandler^ SessionEnding {
	void add (SessionEndingEventHandler^ value);
	void remove (SessionEndingEventHandler^ value);
}
/** @event */
public static void add_SessionEnding (SessionEndingEventHandler value)

/** @event */
public static void remove_SessionEnding (SessionEndingEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.
Not applicable.

Exception typeCondition

InvalidOperationException

System event notifications are not supported under the current context. Server processes, for example, might not support global system event notifications.

ExternalException

The attempt to create a system events window thread did not succeed.

This is a cancelable event. Setting the Cancel property to false will request that the session continues to run. It provides no guarantee that the session will not end.

If you are using SessionEnding in a Windows form to detect a system logoff or reboot, there is no deterministic way to decide whether the Closing event will fire before this event.

If you want to perform some special tasks before Closing is fired, you need to ensure that SessionEnding fires before Closing. To do this, you need to trap the WM_QUERYENDSESSION in the form by overriding the WndProc function.

NoteImportant:

Console applications do not raise the SessionEnding event.

Caution noteCaution:

Because this is a static event, you must detach your event handlers when your application is disposed, or memory leaks will result.

The following code example demonstrates how to trap the WM_QUERYENDSESSION in the form by overriding the WndProc function in a deterministic way.

No code example is currently available or this language may not be supported.

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft