Función RemoveLogContainer (clfsw32.h)

Quita un contenedor de un registro asociado a un identificador de registro dedicado o multiplexado.

Un cliente debe tener privilegios administrativos en el identificador de registro para quitar un contenedor. Para quitar varios contenedores, use la función RemoveLogContainerSet .

Sintaxis

CLFSUSER_API BOOL RemoveLogContainer(
  [in]                HANDLE hLog,
  [in]                LPWSTR pwszContainerPath,
  [in]                BOOL   fForce,
  [in, out, optional] LPVOID pReserved
);

Parámetros

[in] hLog

Identificador del registro que se obtiene de CreateLogFile.

[in] pwszContainerPath

Puntero a una cadena de caracteres anchos que contiene una ruta de acceso para un contenedor de registros creado por AddLogContainer o AddLogContainerSet.

[in] fForce

Marca de eliminación que determina cuándo y cómo se elimina un contenedor.

Si fForce es TRUE y el contenedor forma parte de la región de registro activa, el contenedor no se elimina y se devuelve un error ERROR_LOG_CANT_DELETE .

Si es FALSE, el contenedor se elimina cuando el contenedor ya no forma parte de la región de registro activa.

[in, out, optional] pReserved

Este parámetro está reservado y debe establecerse en NULL.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

De forma predeterminada, la eliminación de contenedores es diferida, lo que significa que un contenedor se elimina solo si no forma parte de un registro activo. Si el contenedor forma parte del registro activo, se marca para su eliminación. Sin embargo, la eliminación no se produce hasta que el final del registro supera el último sector del contenedor o el contenedor tiene un identificador lógico mayor que el identificador lógico del encabezado del registro activo. El tamaño del registro refleja la eliminación del contenedor solo cuando el contenedor se elimina físicamente.

Un cliente de registro puede solicitar una eliminación forzada en un contenedor estableciendo la marca de eliminación en TRUE. Esto tiene el mismo efecto que eliminar un contenedor que no forma parte del registro activo. Sin embargo, si el contenedor forma parte del registro activo, se produce un error en la llamada sin marcar el contenedor para su eliminación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	clfsw32.h
Library	Clfsw32.lib
Archivo DLL	Clfsw32.dll

Consulte también

AddLogContainer

AddLogContainerSet

Funciones comunes del sistema de archivos de registro

OVERLAPPED

RemoveLogContainerSet