Función SetupInitializeFileLogA (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 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 un cadena terminadanull. El parámetro
[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