Función ClfsRemoveLogContainerSet (wdm.h)
El ClfsRemoveLogContainerSet rutinario quita de forma atómica un conjunto de contenedores de un registro CLFS.
Sintaxis
CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
[in] PLOG_FILE_OBJECT plfoLog,
[in] USHORT cContainers,
[in] PUNICODE_STRING rgwszContainerPath,
[in] BOOLEAN fForce
);
Parámetros
[in] plfoLog
Puntero a una estructura de LOG_FILE_OBJECT que representa el registro CLFS del que se quitarán los contenedores. El autor de la llamada obtuvo anteriormente este puntero llamando a ClfsCreateLogFile.
[in] cContainers
Número de contenedores del conjunto. Este es el número de elementos de la matriz de rgwszContainerPath.
[in] rgwszContainerPath
Puntero a una matriz de UNICODE_STRING estructuras, cada una de las cuales proporciona el nombre de ruta de acceso para uno de los contenedores que se van a quitar. El número de elementos de la matriz lo da cContainers. Una ruta de acceso determinada 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 con 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 se fuerza (TRUE) o diferida (FALSE).
Valor devuelto
clfsRemoveLogContainerSet devuelve STATUS_SUCCESS si se ejecuta correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Observaciones
La eliminación forzada de contenedores (fForce = TRUE) solo se realiza correctamente si los contenedores que se van a quitar no forman 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 | 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 |