Platform SDK: Exchange Server

IExchExtModelessCallback::AddWindow

Enables Microsoft Exchange to keep track of modeless windows that are displayed by extensions.

Quick Info

See IExchExtModelessCallback : IUnknown.

HRESULT AddWindow()

Return Values

S_OK
No error occurred.

Remarks

Extension objects should call the IExchExtModelessCallback::AddWindow method when they display a modeless window. This method, along with the IExchExtModelessCallback::ReleaseWindow method, enables Microsoft Exchange to keep track of modeless windows that are displayed by extensions. Microsoft Exchange will not terminate until all extension windows have been closed. It is not necessary to call this method multiple times when multiple modeless windows are displayed.

To enable users to exit Microsoft Exchange with one command, modeless extensions should intercept the Microsoft Exchange Exit and Exit and Log off commands on the File menu. By doing so, extensions can prompt the user to save any changes that have been made and then close the user’s modeless windows, returning S_FALSE to enable other extensions to close their windows as well. In this way, extensions can cooperate with Microsoft Exchange when a user wants to close all windows and exit.

See Also

IExchExtModelessCallback::ReleaseWindow