MsiEnableUIPreview function

The MsiEnableUIPreview function enables preview mode of the user interface to facilitate authoring of user-interface dialog boxes. This function returns a handle that should be closed using MsiCloseHandle.

Syntax


UINT MsiEnableUIPreview(
  _In_   MSIHANDLE hDatabase,
  _Out_  MSIHANDLE *phPreview
);

Parameters

hDatabase [in]

Handle to the database.

phPreview [out]

Pointer to a returned handle for user-interface preview capability.

Return value

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_PARAMETER

Bad parameter.

ERROR_OUTOFMEMORY

Out of memory.

ERROR_SUCCESS

The function succeeded.

Remarks

Note that it is recommended to use variables of type PMSIHANDLE because the installer closes PMSIHANDLE objects as they go out of scope, whereas you must close MSIHANDLE objects by calling MsiCloseHandle. For more information see Use PMSIHANDLE instead of HANDLE section in the Windows Installer Best Practices.

Requirements

Version

Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP

Header

Msiquery.h

Library

Msi.lib

DLL

Msi.dll

See also

User Interface Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft