Función ClfsCloseLogFileObject (wdm.h)
El ClfsCloseLogFileObject rutina 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 anteriormente este puntero llamando a ClfsCreateLogFile.
Valor devuelto
ClfsCloseLogFileObject devuelve STATUS_SUCCESS si se ejecuta correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Observaciones
ClfsCloseLogFileObject 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.
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, su memoria se desasigna). 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 que se cierren todos los objetos de archivo de registro que representan la secuencia.
Al devolver 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (incluya Wdm.h) |
| biblioteca de | Clfs.lib |
| DLL de | Clfs.sys |
| irQL | <= APC_LEVEL |