Función AddLogContainerSet (clfsw32.h)

Agrega varios contenedores de registro al registro físico asociado al identificador de registro, si el proceso de llamada tiene acceso al identificador de registro. Agregar contenedores permite a un cliente aumentar el tamaño de un registro.

Syntax

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

Parámetros

[in] hLog

Identificador de un registro abierto que se obtiene de CreateLogFile con permisos para agregar un contenedor de registros.

El archivo puede ser dedicado o multiplexado.

[in] cContainer

Número de contenedores de la matriz rgwszContainerPath .

Este valor debe ser distinto de cero. Un registro debe tener al menos dos contenedores antes de que se pueda realizar cualquier E/S en él.

[in, optional] pcbContainer

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 (GB).

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). Al agregar 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 al que apunta 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] rgwszContainerPath

Matriz de nombres de ruta de acceso de cContainer para contenedores.

Cada elemento de la matriz es una cadena de caracteres anchos que contiene una ruta de acceso válida para el nuevo contenedor del volumen de registro.

[in, out, optional] pReserved

Reservado. Establezca Reservado en NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero, lo que indica que todos los contenedores se agregan correctamente al registro.

Si se produce un error en la función, el valor devuelto es cero, lo que indica que no se agrega ninguno de los contenedores. Para obtener información de error extendida, llame a GetLastError.

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

Observaciones

La función AddLogContainerSet no es atómica. Si la operación se interrumpe, por ejemplo, por un nombre de ruta de acceso no válida, la llamada a AddLogContainerSet devuelve un error, pero es posible que se hayan creado algunos contenedores. La aplicación debe recuperarse de este error, por ejemplo, al determinar qué contenedores se agregaron.

Dado que AddLogContainerSet agrega más de un contenedor, es más eficaz que realizar llamadas repetidas a AddLogContainer, que solo agrega un contenedor.

Los contenedores se crean y abren en modo no comprimido y se inicializan con 0 (ceros) cuando se crean.

Requisitos

Consulte también

AddLogContainer

Funciones comunes del sistema de archivos de registro

SUPERPUESTO