Función SetupLogErrorW (setupapi.h)
[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 usándose para instalar controladores de dispositivos.
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 SetupLogErrorW(
[in] LPCWSTR 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 avance 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 programa de instalación puede dar formato al parámetro MessageString más adelante (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 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) |