MsiPreviewDialog

[This is preliminary documentation and subject to change.]

The MsiPreviewDialog function displays a dialog box as modeless and inactive.

UINT MsiPreviewDialog(
  MSIHANDLE hPreview,     // preview handle (UI handle)
  LPCTSTR szDialogName    // name of dialog
);
 

Parameters

hPreview

Handle to the preview.

szDialogName

Specifies the name of the dialog box to preview.

Return Values

ERROR_FUNCTION_FAILED

The function failed.

ERROR_FUNCTION_NOT_CALLED

The function was not called.

ERROR_INSTALL_FAILURE

An installation failure occurred.

ERROR_INSTALL_SUSPEND

The installation was suspended.

ERROR_INSTALL_USEREXIT

The user exited the installation.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_HANDLE_STATE

An invalid handle state was supplied.

ERROR_INVALID_PARAMETER

An invalid parameter was supplied.

ERROR_SUCCESS

The function succeeded.

Remarks

Supplying a NULL name in the MsiPreviewDialog function removes any current dialog box.

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 msiquery.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Database Access Reference, User Interface Functions