Compartir a través de

Función SetupLogErrorA (setupapi.h)

  • Artículo

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue utilizándose para instalar controladores de dispositivo.

La función SetupLogError escribe un mensaje de error en un archivo de registro. Está pensado para usarse durante la instalación de Windows, pero siempre está disponible. No está pensado para usarse después de instalar el sistema operativo; en su lugar, se debe usar el registro de eventos.

Sintaxis

WINSETUPAPI BOOL SetupLogErrorA(
  [in] LPCSTR      MessageString,
  [in] LogSeverity Severity
);

Parámetros

[in] MessageString

Puntero a la cadena que se debe guardar en el registro del programa de instalación. El mensaje debe terminar con una combinación de salto de línea de retorno (\r\n). Debe usar una cadena terminada en null. La cadena terminada en null no debe superar el tamaño del búfer de destino. El mensaje siempre se guarda en el registro de acciones, setupact.log. Si Severity es LogSevWarning, LogSevError o LogSevFatalError, el programa de instalación también guarda el mensaje en el registro de errores, setuperr.log. Ambos registros se almacenan en el directorio de Windows.

[in] Severity

Gravedad del mensaje, uno de los siguientes: LogSevInformation, LogSevWarning, LogSevError o LogSevFatalError.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

  • El registro de acciones está pensado para registrar todas las modificaciones realizadas en el sistema durante la instalación de Windows.
  • El registro de errores está pensado para errores durante la instalación solo de Windows.
  • El parámetro MessageString puede ser formateado aún más por el programa de instalación (aunque no realiza ningún procesamiento adicional ahora).
  • El registro de errores se presentará al usuario al final de la configuración del sistema.

Nota

El encabezado setupapi.h define SetupLogError 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

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado setupapi.h
Library Setupapi.lib
Archivo DLL Setupapi.dll
Conjunto de API ext-ms-win-setupapi-logging-l1-1-0 (introducido en Windows 8)

Vea también

Funciones

Información general