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

Consulte también

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer