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. Puede modificarse o no estar disponible en versiones posteriores. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usá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 suministro 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 gravedad 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, LogSevErroro LogSevFatalError.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

  • 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 dar formato más a través del 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de setupapi.h
biblioteca de Setupapi.lib
DLL de Setupapi.dll
conjunto de API de ext-ms-win-setupapi-logging-l1-1-0 (introducido en Windows 8)

Consulte también

funciones de

información general