MsiSetExternalUI

[This is preliminary documentation and subject to change.]

The MsiSetExternalUI function enables an external user-interface handler. This user interface is then used for all subsequent calls to user-interface-generating installer functions in this process.

INSTALLUI_HANDLER MsiSetExternalUI(
  INSTALLUI_HANDLER puiHandler, // UI handler
  DWORD dwMessageFilter,        // bit flags designating which messages to handle
  LPVOID pvContext              // application context
);
 

Parameters

puiHandler

Specifies a callback function that conforms to the INSTALLUI_HANDLER specification.

dwMessageFilter

Specifies which messages to handle.

pvContext

Pointer to an application context. This context is returned to the application through the user-interface handler.

Return Values

The return value is the previously set external handler, or 0 if there was no previously set handler.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msi.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Interface and Logging Functions