Función SetupInitializeFileLogA (setupapi.h)

Artículo
03/13/2024

[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 SetupInitializeFileLog inicializa un archivo para registrar las operaciones y los resultados de la instalación. Puede ser el registro del sistema, donde el sistema realiza un seguimiento de los archivos instalados como parte de Windows o cualquier otro archivo.

Sintaxis

WINSETUPAPI HSPFILELOG SetupInitializeFileLogA(
  [in] PCSTR LogFileName,
  [in] DWORD Flags
);

Parámetros

[in] LogFileName

Puntero opcional al nombre de archivo del archivo que se va a usar como archivo de registro. Debe usar una cadena terminada en NULL. El parámetro LogFileName debe especificarse si Flags no incluye SPFILELOG_SYSTEMLOG. No se debe especificar el parámetro LogFileName si Flags incluye SPFILELOG_SYSTEMLOG. Este parámetro puede ser NULL.

[in] Flags

Controla la inicialización del archivo de registro. Este parámetro puede ser una combinación de los valores siguientes.

SPFILELOG_SYSTEMLOG

Use el registro de archivos del sistema. El usuario debe ser un administrador para especificar esta opción a menos que se especifique SPFILELOG_QUERYONLY y no se especifique LogFileName . No especifique SPFILELOG_SYSTEMLOG en combinación con SPFILELOG_FORCENEW.

SPFILELOG_FORCENEW

Si el archivo de registro existe, sobrescriba. Si el archivo de registro existe y no se especifica esta marca, los nuevos archivos instalados se agregan a la lista en el archivo de registro existente. No especifique en combinación con SPFILELOG_SYSTEMLOG.

SPFILELOG_QUERYONLY

Abra el archivo de registro solo para realizar consultas.

Valor devuelto

La función devuelve el identificador al archivo de registro si se realiza correctamente. De lo contrario, el valor devuelto es INVALID_HANDLE_VALUE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

Nota

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