Función ClfsCloseAndResetLogFile (wdm.h)

La rutina ClfsCloseAndResetLogFile libera todas las referencias a un objeto de archivo de registro especificado y marca su secuencia asociada para el restablecimiento.

Sintaxis

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

Parámetros

[in] plfoLog

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

Valor devuelto

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

Comentarios

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

ClfsCloseAndResetLogFile 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, su memoria está desasignada). Es posible que la secuencia representada por el objeto de archivo de registro no se restablezca, sin embargo, porque podría haber otros objetos de archivo de registro que representen la misma secuencia. La secuencia se restablece después de que se cierren todos los objetos de archivo de registro que representan la secuencia (por ejemplo, mediante llamadas a ClfsCloseLogFileObject).

Una secuencia de restablecimiento es como una secuencia recién creada que nunca ha tenido ningún registro escrito en él.

Al volver de esta rutina, plfoLog no es válido.

Puede llamar a ClfsCloseAndResetLogFile como máximo 124 veces para una secuencia determinada.

Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.

Requisitos

Consulte también

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile