Funzione CertSrvBackupTruncateLogs (certbcli.h)

Articolo
08/22/2023

La funzione CertSrvBackupTruncateLogs elimina i record ridondanti e riduce lo spazio di archiviazione su disco usato dai file di log. Prima di troncare i file di log, assicurarsi che sia stato protetto un backup di tutti i file restituiti da CertSrvBackupGetDatabaseNames e CertSrvBackupGetBackupLogs .

Sintassi

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

Parametri

[in] hbc

Handle per un contesto di backup di Servizi certificati.

Valore restituito

Il valore restituito è HRESULT. Il valore S_OK indica l'esito positivo.

Commenti

Dopo la protezione di un backup dei file di database e di log, i file di log possono essere troncati facoltativamente. Il volume dei file di log aumenta con l'attività del database e il troncamento dei file di log ridurrà i record ridondanti nei file di log, riducendo così lo spazio su disco usato per archiviare i file di log.

I file di log vengono forniti per l'integrità e l'efficienza del database. Se si verifica un'uscita non normale con l'applicazione Servizi certificati, al successivo avvio di Servizi certificati, il database riproduce i file di log per impedire l'introduzione del danneggiamento dei dati nel database.

A seconda del volume dei file di log, la riproduzione del file di log può richiedere molto tempo. Durante questa riproduzione, l'autorità di certificazione non sarà disponibile per altre attività. Si noti che se l'applicazione Servizi certificati viene arrestata correttamente (ad esempio arrestando il servizio o arrestando correttamente il sistema operativo), i file di log non vengono riprodotti alla successiva avvio.

Nota Se si chiama CertSrvBackupTruncateLogs senza eseguire il backup di tutti i file restituiti da CertSrvBackupGetDatabaseNames e CertSrvBackupGetBackupLogs, non sarà possibile ripristinare correttamente il set di backup, generando un computer servizi certificati inutilizzabile. Chiamare pertanto CertSrvBackupTruncateLogs solo quando il set di backup contiene tutti i file restituiti da CertSrvBackupGetDatabaseNames e CertSrvBackupGetBackupLogs.

Esempio

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");

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certbcli.h (include Certsrv.h)
Libreria	Certadm.lib
DLL	Certadm.dll

Vedi anche

CertSrvBackupGetBackupLogs

Uso delle funzioni di backup e ripristino dei servizi certificati

Condividi tramite