Funzione CertSrvBackupTruncateLogs (certbcli.h)

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.

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

Vedi anche

CertSrvBackupGetBackupLogs

Uso delle funzioni di backup e ripristino dei servizi certificati