DMessengerEvents::OnAppShutdown Event

  • Article

Deprecated. 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(VOID);

Return Value

No return value.

Event DISPID

DISPID_MUAE_ONAPPSHUTDOWN

The DISPID for this event is defined in msgrua.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

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.

Important  DMessengerEvents::OnAppShutdown is no longer available in Windows Vista. See Windows Messenger for more information.