MsiEnableLog

[This is preliminary documentation and subject to change.]

The MsiEnableLog function sets the log mode for all installations that are initiated in the calling process.

UINT MsiEnableLog(
  DWORD dwLogMode,     // flags designating operations to report
  LPCTSTR szLogFile,   // log file or NULL for external handler
  BOOL fAppend         // value to indicate append mode
);
 

Parameters

dwLogMode

Specifies the log mode. This parameter can be one or more of the following values.

Value	Meaning
INSTALLLOGMODE_OUTOFMEMORY	The out-of-memory error messages are logged.
INSTALLLOGMODE_ERROR	The error messages are logged.
INSTALLLOGMODE_WARNING	The warning messages are logged.
INSTALLLOGMODE_USER	The user requests are logged.
INSTALLLOGMODE_INFO	The status messages that are not displayed are logged.
INSTALLLOGMODE_COMMONDATA	The parameters for user-interface initialization are logged.
INSTALLLOGMODE_RESERVED	Reserved for future use.
INSTALLLOGMODE_ACTIONSTART	The start of new installation actions are logged.
INSTALLLOGMODE_ACTIONDATA	The data record with the installation action is logged.
INSTALLLOGMODE_PROPERTYDUMP	The property values at termination are logged.
INSTALLLOGMODE_FILESINUSE	List of files that need to be replaced.

szLogFile

Specifies the string that holds the full path to the log file. The file is created if it does not exist.

fAppend

Specifies a Boolean value. This value is set to TRUE to append an existing file, and it is set to FALSE to replace the contents.

Return Values

ERROR_INVALID_PARAMETER

An invalid log mode was specified.

ERROR_SUCCESS

The function succeeded.

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