Función MsiEnableLogA (msi.h)

  • Artículo

La función MsiEnableLog establece el modo de registro para todas las instalaciones posteriores que se inician en el proceso de llamada.

Sintaxis

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

Parámetros

[in] dwLogMode

Especifica el modo de registro. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
INSTALLLOGMODE_FATALEXIT
 Cierra la memoria o la información de salida irrecuperable.
INSTALLLOGMODE_ERROR
 Registra los mensajes de error.
INSTALLLOGMODE_EXTRADEBUG
 Envía información adicional de depuración, como controlar la información de creación, al archivo de registro.

Windows 2000 y Windows XP: Esta característica no se admite.
INSTALLLOGMODE_WARNING
 Registra los mensajes de advertencia.
INSTALLLOGMODE_USER
 Registra las solicitudes del usuario.
INSTALLLOGMODE_INFO
 Registra los mensajes de estado que no se muestran.
INSTALLLOGMODE_RESOLVESOURCE
 Solicitud para determinar una ubicación de origen válida.
INSTALLLOGMODE_OUTOFDISKSPACE
 Indica un espacio en disco insuficiente.
INSTALLLOGMODE_ACTIONSTART
 Registra el inicio de nuevas acciones de instalación.
INSTALLLOGMODE_ACTIONDATA
 Registra el registro de datos con la acción de instalación.
INSTALLLOGMODE_COMMONDATA
 Registra los parámetros para la inicialización de la interfaz de usuario.
INSTALLLOGMODE_PROPERTYDUMP
 Registra los valores de propiedad al finalizar.
INSTALLLOGMODE_VERBOSE
 Registra la información en todos los demás modos de registro, excepto por INSTALLLOGMODE_EXTRADEBUG. Esto envía grandes cantidades de información a un archivo de registro no generalmente útil para los usuarios. Se puede usar para soporte técnico.
INSTALLLOGMODE_LOGONLYONERROR
 La información de registro se recopila, pero se guarda con menos frecuencia en el archivo de registro. Esto puede mejorar el rendimiento de algunas instalaciones, pero puede tener pocas ventajas para instalaciones de gran tamaño. El archivo de registro se quita cuando la instalación se realiza correctamente. Si se produce un error en la instalación, toda la información de registro se guarda en el archivo de registro.

Windows Installer 2.0: Este modo de registro no está disponible.

[in] szLogFile

Especifica la cadena que contiene la ruta de acceso completa al archivo de registro. Al escribir un valor NULL, se deshabilita el registro, en cuyo caso se omite dwlogmode . Si se proporciona una ruta de acceso, dwlogmode no debe ser cero.

[in] dwLogAttributes

Especifica la frecuencia con la que se va a vaciar el búfer de registro.

Valor Significado
INSTALLLOGATTRIBUTES_APPEND
 Si se establece este valor, el instalador anexa el registro existente especificado por szLogFile. Si no se establece, se sobrescribe cualquier registro existente especificado por szLogFile .
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Obliga a vaciar el búfer de registro después de cada línea. Si no se establece este valor, el instalador vacía el búfer de registro después de 20 líneas llamando a FlushFileBuffers.

Valor devuelto

Valor Significado
ERROR_INVALID_PARAMETER
 Se especificó un modo de registro no válido.
ERROR_SUCCESS
 La función se ha realizado correctamente.

Comentarios

Para obtener una descripción de la directiva de registro, consulte Directiva del sistema.

La ruta de acceso a la ubicación del archivo de registro ya debe existir al usar esta función. El instalador no crea la estructura de directorios para el archivo de registro.

Nota:

El encabezado msi.h define MsiEnableLog como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino Windows
Encabezado msi.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de interfaz y registro

Registro