Función ClfsRemoveLogContainer (wdm.h)
La rutina ClfsRemoveLogContainer quita un contenedor de un registro clFS.
Sintaxis
CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PUNICODE_STRING puszContainerPath,
[in] BOOLEAN fForce
);
Parámetros
[in] plfoLog
Puntero a una estructura LOG_FILE_OBJECT que representa un registro CLFS del que se quitará el contenedor. El autor de la llamada obtuvo previamente este puntero mediante una llamada a ClfsCreateLogFile.
[in] puszContainerPath
Puntero a una estructura UNICODE_STRING que proporciona el nombre de ruta de acceso del contenedor que se va a quitar. El nombre de la ruta de acceso se creó en una llamada anterior a ClfsAddLogContainer o ClfsAddLogContainerSet. La ruta de acceso puede ser absoluta o relativa a la ubicación del archivo de registro base para el registro CLFS representado por plfoLog. Las rutas de acceso relativas al archivo de registro base deben comenzar por CLFS_CONTAINER_RELATIVE_PREFIX, que es el literal de cadena (L"%BLF%\"). Los directorios "." y ".." no se permiten en una ruta de acceso relativa.
[in] fForce
Valor booleano que especifica si la eliminación del contenedor es forzada (TRUE) o diferida (FALSE).
Valor devuelto
ClfsRemoveLogContainer devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
La eliminación forzada del contenedor (fForce = TRUE) solo se realiza correctamente si el contenedor que se va a quitar no forma parte del registro activo.
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 |