Función ClfsDeleteLogFile (wdm.h)
La rutina ClfsDeleteLogFile marca una secuencia CLFS para su eliminación.
Sintaxis
CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
[in] PUNICODE_STRING puszLogFileName,
PVOID pvReserved,
[in] ULONG fLogOptionFlag,
[in, optional] PVOID pvContext,
[in] ULONG cbContext
);
Parámetros
[in] puszLogFileName
Puntero a una estructura de UNICODE_STRING que proporciona el nombre de la secuencia CLFS que se va a eliminar.
Si la secuencia que se va a eliminar es la única secuencia de un registro dedicado, el nombre tiene el formato log:physical log name, donde physical log name es el nombre de la ruta de acceso del registro físico en el sistema de archivos subyacente.
Si la secuencia que se va a eliminar es una de las secuencias de un registro multiplexado, el nombre tiene el formato log:physical log name::stream name, donde physical log name es el nombre de la ruta de acceso del registro físico en el sistema de archivos subyacente y el nombre de la secuencia es el nombre único de la secuencia que se va a eliminar.
pvReserved
Reservado.
[in] fLogOptionFlag
Valor que indica la relación entre CLFS y el componente que está eliminando el registro. Para obtener una lista de los valores posibles, vea la descripción del parámetro fLogOptionFlag de la rutina ClfsCreateLogFile .
[in, optional] pvContext
Puntero a un contexto. La forma en que se interpreta el contexto depende del valor pasado en fLogOptionFlag.
[in] cbContext
Tamaño, en bytes, del contexto al que apunta pvContext. Si pvContext no es NULL, este parámetro debe ser mayor que cero.
Valor devuelto
ClfsDeleteLogFile devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
El sistema de archivos de registro común (CLFS) usa la estructura de LOG_FILE_OBJECT para representar los registros. La función ClfsCreateLogFile devuelve un puntero a LOG_FILE_OBJECT, que los clientes pasan a otras funciones CLFS.
Los clientes CLFS no acceden directamente a los miembros de una estructura de LOG_FILE_OBJECT. Para obtener información sobre los miembros, vea FILE_OBJECT.
ClfsDeleteLogFile marca una secuencia para su eliminación, pero no cierra ningún objeto de archivo de registro que esté abierto actualmente. Para cerrar un objeto de archivo de registro, llame a ClfsCloseLogFileObject. Una secuencia marcada para su eliminación se elimina después de cerrar todos los objetos de archivo de registro asociados a la secuencia.
Una secuencia CLFS marcada para su eliminación rechazará las solicitudes posteriores para abrir la secuencia.
El nombre de un registro CLFS físico no incluye la extensión .blf.
Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h) |
| Library | Clfs.lib |
| Archivo DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |