Función AddLogContainer (clfsw32.h)

Agrega un contenedor al registro físico asociado al identificador de registro; si el proceso de llamada tiene acceso de escritura al archivo .blf y la capacidad de crear archivos en el directorio de destino del contenedor.

Esta función es diferente de AddLogContainerSet, ya que solo agrega un contenedor. Para agregar varios contenedores, es más eficaz usar AddLogContainerSet, lo que le permite agregar más de un contenedor. Agregar contenedores permite a un cliente aumentar el tamaño de un registro.

Sintaxis

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Parámetros

[in] hLog

Identificador de un registro abierto.

El identificador debe obtenerse de CreateLogFile con acceso de escritura al registro. La aplicación cliente debe tener acceso de escritura al archivo .blf y la capacidad de crear archivos en el directorio de destino de un contenedor.

[in, optional] pcbContainer

Parámetro opcional que especifica el tamaño del contenedor, en bytes.

El tamaño mínimo es de 512 KB para los registros normales y 1024 KB para los registros multiplexados. El tamaño máximo es de aproximadamente 4 gigabytes.

Este parámetro es necesario si los contenedores se agregan a un registro recién creado. Si ya se ha creado un contenedor, este parámetro puede ser NULL o algún valor que sea al menos tan grande como el tamaño del primer contenedor.

Los tamaños del contenedor de registros son múltiplo del tamaño de la región de registro (512 KB). Cuando se agrega un contenedor a un nuevo archivo, la función AddLogContainer redondea el tamaño del contenedor hasta el siguiente límite de 512 KB y devuelve ese tamaño en el valor señalado por pcbContainer.

Del mismo modo, si el registro ya tiene al menos un contenedor y el valor de *pcbContainer es al menos tan grande como el tamaño del contenedor actual, la función crea todos los contenedores con el tamaño interno actual y devuelve ese tamaño en *pcbContainer.

[in] pwszContainerPath

Puntero a una cadena terminada en null que contiene una ruta de acceso válida para el nuevo contenedor en un volumen de registro.

[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:

Requisitos

Consulte también

AddLogContainerSet

Funciones comunes del sistema de archivos de registro

CreateLogFile