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

Syntax

C++UINT MsiEnableLog(
  __in  DWORD dwLogMode,
  __in  LPCTSTR szLogFile,
  __in  DWORD dwLogAttributes
);

Parameters

dwLogMode [in]

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

Value	Meaning
INSTALLLOGMODE_FATALEXIT	Logs out of memory or fatal exit information.
INSTALLLOGMODE_ERROR	Logs the error messages.
INSTALLLOGMODE_EXTRADEBUG	Sends extra debugging information, such as handle creation information, to the log file. Windows 2000 and Windows XP:  This feature is not supported.
INSTALLLOGMODE_WARNING	Logs the warning messages.
INSTALLLOGMODE_USER	Logs the user requests.
INSTALLLOGMODE_INFO	Logs the status messages that are not displayed.
INSTALLLOGMODE_RESOLVESOURCE	Request to determine a valid source location.
INSTALLLOGMODE_OUTOFDISKSPACE	Indicates insufficient disk space.
INSTALLLOGMODE_ACTIONSTART	Logs the start of new installation actions.
INSTALLLOGMODE_ACTIONDATA	Logs the data record with the installation action.
INSTALLLOGMODE_COMMONDATA	Logs the parameters for user-interface initialization.
INSTALLLOGMODE_PROPERTYDUMP	Logs the property values at termination.
INSTALLLOGMODE_VERBOSE	Logs the information in all the other log modes, except for INSTALLLOGMODE_EXTRADEBUG. This sends large amounts of information to a log file not generally useful to users. May be used for technical support.
INSTALLLOGMODE_LOGONLYONERROR	Logging information is collected but is is less frequently saved to the log file. This can improve the performance of some installations, but may have little benefit for large installations. The log file is removed when the installation succeeds. If the installation fails, all logging information is saved to the log file. Windows Installer 2.0:  This log mode is not available.

 

szLogFile [in]

Specifies the string that holds the full path to the log file. Entering a null disables logging, in which case dwlogmode is ignored. If a path is supplied, then dwlogmode must not be zero.

dwLogAttributes [in]

Specifies how frequently the log buffer is to be flushed.

Value	Meaning
INSTALLLOGATTRIBUTES_APPEND	If this value is set, the installer appends the existing log specified by szLogFile. If not set, any existing log specified by szLogFile is overwritten.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE	Forces the log buffer to be flushed after each line. If this value is not set, the installer flushes the log buffer after 20 lines by calling FlushFileBuffers.

 

Return Value

Value	Meaning
ERROR_INVALID_PARAMETER	An invalid log mode was specified.
ERROR_SUCCESS	The function succeeded.

 

Remarks

For a description of the Logging policy, see System Policy.

The path to the log file location must already exist when using this function. The Installer does not create the directory structure for the log file.

Requirements

Version	Windows Installer 5.0 on 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, Windows XP, and Windows 2000. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
Header	Msi.h
Library	Msi.lib
DLL	Msi.dll
Unicode and ANSI names	MsiEnableLogW (Unicode) and MsiEnableLogA (ANSI)

See Also

Interface and Logging Functions

Logging

Send comments about this topic to Microsoft

Build date: 8/13/2009