DMessengerEvents::OnAppShutdown event

[OnAppShutdown is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Indicates that the client application is about to shut down for purposes of a client upgrade initiated either by the server or client user.

Syntax

void OnAppShutdown();

Parameters

This event has no parameters.

Return value

This event does not return a value.

Remarks

After this event is issued, the application shuts down. Any references held will become invalid and, if not deallocated, might create memory leaks.

This event is generally sent only if the client is forced to shut down in order to complete a mandatory upgrade, as determined during a sign-in exchange sequence. Alternatively, the client user might have affirmed a dialog box for an optional upgrade. This event is not issued as a result of a standard application quit, minimize, or system shutdown without client upgrade involved. The event is issued only in upgrade path scenarios.

Note

This event is available for scripting languages.

Requirements

Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Product
Messenger 4.5
Header
Msgrua.h
IDL
Msgrua.idl
DLL
Msgsc.dll