Función ClfsRemoveLogContainerSet (wdm.h)

La rutina ClfsRemoveLogContainerSet 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 previamente este puntero mediante una llamada a ClfsCreateLogFile.

[in] cContainers

Número de contenedores del conjunto. Este es el número de elementos de la matriz rgwszContainerPath .

[in] rgwszContainerPath

Puntero a una matriz de estructuras de UNICODE_STRING , cada una de las cuales proporciona el nombre de ruta de acceso para uno de los contenedores que se van a quitar. CContainers asigna el número de elementos de la matriz. 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 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

ClfsRemoveLogContainerSet 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 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	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

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING