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

Syntax

C++UINT MsiPreviewDialog(
  __in  MSIHANDLE hPreview,
  __in  LPCTSTR szDialogName
);

Parameters

hPreview [in]

Handle to the preview.

szDialogName [in]

Specifies the name of the dialog box to preview.

Return Value

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.

Requirements

See Also

User Interface Functions

Send comments about this topic to Microsoft

Build date: 8/13/2009