Función SetLogFileSizeWithPolicy (clfsmgmtw32.h)

  • Artículo

Agrega o elimina contenedores de un registro en función del estado de las directivas instaladas.

Sintaxis

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

Parámetros

[in] hLog

Identificador de un registro.

[in] pDesiredSize

Puntero a un valor que especifica el tamaño de registro solicitado, expresado como uno de los valores siguientes. Para obtener el tamaño resultante real, consulte el parámetro pResultingSize .

Valor Significado
0
 Aplique la directiva de tamaño mínimo.

Si no se instala una directiva de tamaño mínimo, se produce una de las siguientes acciones:

  • Si el registro tiene menos de dos contenedores, el registro se expandirá a un tamaño de dos contenedores.
  • Si el registro tiene dos o más contenedores, no se realiza ningún cambio y la llamada de función se realiza correctamente.

Si se instala una directiva de tamaño mínimo, se produce una de las siguientes acciones:

  • Si el registro tiene menos del número mínimo de contenedores especificados por la directiva de tamaño mínimo, el registro se expande al número mínimo de contenedores especificado por la directiva.
  • Si el registro tiene un número de contenedores mayor o igual que el número mínimo de contenedores especificados por la directiva de tamaño mínimo, no se realizan cambios y la llamada de función se realiza correctamente sin errores.

Para obtener más información, vea InstallLogPolicy.
1
 No es un valor válido; Se produce un error en la llamada de función con ERROR_INVALID_PARAMETER.
2–1023
 Tamaño deseado del registro, expresado como el número de contenedores.

Si este número es menor que el número mínimo de contenedores especificados por la directiva instalada, se produce un error en la llamada de función con ERROR_COULD_NOT_RESIZE_LOG.

Si este número es mayor que el número máximo de contenedores especificados por la directiva instalada, el registro solo se expande hasta el número máximo de contenedores especificado por la directiva y la función se realiza correctamente sin errores.
1024–MAXULONGLONG
 Si no se instala ninguna directiva de tamaño máximo, se produce un error en la llamada de función con ERROR_LOG_POLICY_CONFLICT.

Si se instala una directiva de tamaño máximo, el registro se expande al número máximo de contenedores especificado por la directiva de tamaño máximo y la función se realiza correctamente sin errores.

[out] pResultingSize

Un puntero a una variable de datos de ULONGLONG válida, recibe el número de contenedores del registro cuyo tamaño se ha cambiado cuando se ha realizado correctamente.

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 ampliada de los errores, llame a la función GetLastError.

Comentarios

Los contenedores se crean con los mismos atributos de seguridad que el archivo .blf y se crean dentro del contexto de la aplicación, no el contexto del propietario del archivo .blf. Para obtener más información sobre los archivos .blf, vea Tipos de registro. Si se eliminan los contenedores, se eliminan mediante el contexto de seguridad de la aplicación que realiza la llamada.

Ejemplos

Para obtener un ejemplo en el que se usa esta función, vea Creating a Log File.

Requisitos

   
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 clfsmgmtw32.h
Library Clfsw32.lib
Archivo DLL Clfsw32.dll

Consulte también

Crear un archivo de registro

InstallLogPolicy

Tipos de registro