Función SetupInitializeFileLogW (setupapi.h)

[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 SetupInitializeFileLog inicializa un archivo para registrar los resultados y las operaciones de 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 SetupInitializeFileLogW(
  [in] PCWSTR 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 un cadena terminadanull. 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 siguientes valores.

SPFILELOG_SYSTEMLOG

Use el registro de archivos del sistema. El usuario debe ser 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 ejecuta correctamente. De lo contrario, el valor devuelto es INVALID_HANDLE_VALUE y un error registrado se puede recuperar mediante una llamada a GetLastError.

Observaciones

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 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

Consulte también

funciones de

información general

setupLogFile

SetupTerminateFileLog