Función CertSrvBackupTruncateLogs (certbcli.h)

La función CertSrvBackupTruncateLogs elimina los registros redundantes y reduce el espacio de almacenamiento en disco usado por los archivos de registro. Antes de truncar los archivos de registro, asegúrese de que se ha protegido una copia de seguridad de todos los archivos devueltos por CertSrvBackupGetDatabaseNames y CertSrvBackupGetBackupLogs .

Sintaxis

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

Parámetros

[in] hbc

Identificador de un contexto de copia de seguridad de Servicios de certificados.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que se ha realizado correctamente.

Comentarios

Después de proteger una copia de seguridad de la base de datos y los archivos de registro, los archivos de registro se pueden truncar opcionalmente. El volumen de archivos de registro aumenta con la actividad de la base de datos y el truncamiento de los archivos de registro reducirá los registros redundantes en los archivos de registro (lo que reduce el espacio en disco usado para almacenar los archivos de registro).

Los archivos de registro se proporcionan para la integridad y eficiencia de la base de datos. Si se produce una salida menos correcta con la aplicación Certificate Services, la próxima vez que se inicie Certificate Services, la base de datos reproduce los archivos de registro para evitar que se introduzcan datos dañados en la base de datos.

En función del volumen de los archivos de registro, la reproducción del archivo de registro puede llevar mucho tiempo. Durante esta reproducción, la entidad de certificación no estará disponible para otra actividad. Tenga en cuenta que si la aplicación servicios de certificados se detiene correctamente (por ejemplo, deteniendo el servicio o cerrando correctamente el sistema operativo), los archivos de registro no se reproducen la próxima vez que se inicie.

Nota Si llama a CertSrvBackupTruncateLogs sin realizar una copia de seguridad de todos los archivos devueltos desde CertSrvBackupGetDatabaseNames y CertSrvBackupGetBackupLogs, no podrá restaurar correctamente el conjunto de copia de seguridad, lo que da lugar a una máquina de Servicios de certificados no utilizable. Por lo tanto, llame a CertSrvBackupTruncateLogs solo cuando el conjunto de copia de seguridad contenga todos los archivos devueltos desde CertSrvBackupGetDatabaseNames y CertSrvBackupGetBackupLogs.

 

Ejemplos

FNCERTSRVBACKUPTRUNCATELOGS* pfnTruncateLogs;
char * szTruncateLogsFunc = "CertSrvBackupTruncateLogs";

HRESULT    hr=0;

// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnTruncateLogs = (FNCERTSRVBACKUPTRUNCATELOGS*)GetProcAddress( hInst,
                                           szTruncateLogsFunc );
if ( NULL == pfnTruncateLogs )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szTruncateLogsFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// After they have been backed up, truncate the logs.
// hCSBC is a previously set HCSBC variable.
hr = pfnTruncateLogs(hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnTruncateLogs call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}
else
    printf("Logs truncated\n");

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certbcli.h (incluya Certsrv.h)
Library	Certadm.lib
Archivo DLL	Certadm.dll

Consulte también

CertSrvBackupGetBackupLogs

Uso de las funciones de copia de seguridad y restauración de Servicios de certificados