Función RemoveLogContainerSet (clfsw32.h)

Quita varios contenedores 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. La función RemoveLogContainer es un caso especial de esta función RemoveLogContainerSet , ya que solo quita un contenedor. Para quitar varios contenedores, use RemoveLogContainerSet.

Sintaxis

CLFSUSER_API BOOL RemoveLogContainerSet(
  [in]                HANDLE hLog,
  [in]                USHORT cContainer,
  [in]                LPWSTR *rgwszContainerPath,
  [in]                BOOL   fForce,
  [in, out, optional] LPVOID pReserved
);

Parámetros

[in] hLog

Identificador del registro que se obtiene de CreateLogFile.

El identificador de registro debe tener permiso administrativo para agregar un contenedor de registros y puede hacer referencia a un registro dedicado o multiplexado.

[in] cContainer

Número de nombres de ruta de acceso de contenedor en una matriz a la que apunta rgwszContainerPath.

Este valor debe ser distinto de cero.

[in] rgwszContainerPath

Matriz de punteros a nombres de ruta de acceso de contenedor que contienen punteros cContainers .

Cada nombre de ruta de acceso es una cadena de caracteres anchos que identifica un contenedor 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

Reservado. Establezca pReserved enNULL.

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 del registro activo. Si el contenedor forma parte del registro activo, se marca para su eliminación. Esta eliminación se aplaza 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 un contenedor forma parte del registro activo, se produce un error en la llamada sin marcar el contenedor para su eliminación.

Requisitos

Consulte también

AddLogContainer

AddLogContainerSet

Funciones comunes del sistema de archivos de registro

OVERLAPPED

RemoveLogContainer