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.

Sintaxis

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 registro.

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). 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] 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:

Comentarios

La función AddLogContainerSet no es atómica. Si se interrumpe la operación, por ejemplo, por un nombre de ruta de acceso no válido, 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 un 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

OVERLAPPED