Función ClfsCloseLogFileObject (wdm.h)

  • Artículo

La rutina ClfsCloseLogFileObject libera todas las referencias a un objeto de archivo de registro.

Sintaxis

CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
  [in] PLOG_FILE_OBJECT plfoLog
);

Parámetros

[in] plfoLog

Puntero a la estructura LOG_FILE_OBJECT para la que se liberarán las referencias. El autor de la llamada obtuvo previamente este puntero mediante una llamada a ClfsCreateLogFile.

Valor devuelto

ClfsCloseLogFileObject devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

ClfsCloseLogFileObject libera todas las referencias adquiridas por CLFS al objeto de archivo de registro especificado. Normalmente, el cliente no habrá adquirido ninguna referencia adicional al objeto de archivo de registro. Sin embargo, si el cliente ha obtenido referencias adicionales, es responsabilidad del cliente liberarlas.

ClfsCloseLogFileObject hace que el recuento de referencias del objeto de archivo de registro especificado se quite a cero, en cuyo momento se cierra el objeto de archivo de registro (es decir, se desasigna su memoria). Sin embargo, la secuencia representada por el objeto de archivo de registro podría permanecer abierta, ya que podría haber otros objetos de archivo de registro que representen la misma secuencia. La secuencia se cierra después de cerrar todos los objetos de archivo de registro que representan la secuencia.

A cambio de esta rutina, plfoLog no es válido.

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

ClfsCreateLogFile