CertSrvBackupTruncateLogs-Funktion (certbcli.h)

Artikel
03/01/2024

Die CertSrvBackupTruncateLogs-Funktion eliminiert redundante Datensätze und reduziert den von Protokolldateien belegten Speicherplatz. Stellen Sie vor dem Abschneiden der Protokolldateien sicher, dass eine Sicherung aller Von CertSrvBackupGetDatabaseNames und CertSrvBackupGetBackupLogs zurückgegebenen Dateien gesichert wurde.

Syntax

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

Parameter

[in] hbc

Ein Handle für einen Sicherungskontext für Zertifikatdienste.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt den Erfolg an.

Hinweise

Nach dem Sichern einer Sicherung der Datenbank- und Protokolldateien können die Protokolldateien optional abgeschnitten werden. Das Protokolldateivolume nimmt mit der Datenbankaktivität zu, und das Abschneiden der Protokolldateien reduziert die redundanten Datensätze in den Protokolldateien (wodurch der zum Speichern der Protokolldateien verwendete Speicherplatz verringert wird).

Die Protokolldateien werden aus Gründen der Datenbankintegrität und -effizienz bereitgestellt. Wenn die Zertifikatdiensteanwendung weniger als ordnungsgemäß beendet wird, gibt die Datenbank beim nächsten Starten der Zertifikatdienste die Protokolldateien wieder, um zu verhindern, dass Datenbeschädigungen in die Datenbank eingeführt werden.

Abhängig vom Volume der Protokolldateien kann die Wiedergabe der Protokolldatei ein zeitaufwändiger Prozess sein. Während dieser Wiedergabe ist die Zertifizierungsstelle für andere Aktivitäten nicht verfügbar. Beachten Sie, dass die Protokolldateien beim nächsten Start nicht wiedergegeben werden, wenn die Zertifikatdienstanwendung ordnungsgemäß angehalten wird (z. B. durch Beenden des Diensts oder durch ordnungsgemäßes Herunterfahren des Betriebssystems).

Hinweis Wenn Sie CertSrvBackupTruncateLogs aufrufen, ohne alle Dateien zu sichern, die von CertSrvBackupGetDatabaseNames und CertSrvBackupGetBackupLogs zurückgegeben werden, können Sie den Sicherungssatz nicht erfolgreich wiederherstellen, was zu einem nicht verwendbaren Zertifikatdienstcomputer führt. Rufen Sie daher CertSrvBackupTruncateLogs nur auf, wenn der Sicherungssatz alle Dateien enthält, die von CertSrvBackupGetDatabaseNames und CertSrvBackupGetBackupLogs zurückgegeben werden.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certbcli.h (certsrv.h einschließen)
Bibliothek	Certadm.lib
DLL	Certadm.dll

Weitere Informationen

CertSrvBackupGetBackupLogs

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über