CertSrvBackupTruncateLogs, fonction (certbcli.h)

Article
08/22/2023

La fonction CertSrvBackupTruncateLogs élimine les enregistrements redondants et réduit l’espace de stockage disque utilisé par les fichiers journaux. Avant de tronquer les fichiers journaux, assurez-vous qu’une sauvegarde de tous les fichiers retournés par CertSrvBackupGetDatabaseNames et CertSrvBackupGetBackupLogs a été sécurisée.

Syntaxe

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

Paramètres

[in] hbc

Handle vers un contexte de sauvegarde des services de certificats.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite.

Remarques

Après avoir sécurisé une sauvegarde de la base de données et des fichiers journaux, les fichiers journaux peuvent éventuellement être tronqués. Le volume des fichiers journaux augmente avec l’activité de la base de données, et la troncation des fichiers journaux réduit les enregistrements redondants dans les fichiers journaux (réduisant ainsi l’espace disque utilisé pour stocker les fichiers journaux).

Les fichiers journaux sont fournis pour l’intégrité et l’efficacité de la base de données. Si une sortie peu normale se produit avec l’application Services de certificats, la prochaine fois que les services de certificats sont démarrés, la base de données relit les fichiers journaux pour empêcher l’introduction d’une altération des données dans la base de données.

Selon le volume des fichiers journaux, la relecture du fichier journal peut prendre du temps. Pendant cette relecture, l’autorité de certification ne sera pas disponible pour d’autres activités. Notez que si l’application Services de certificats est correctement arrêtée (par exemple, en arrêtant le service ou en arrêtant correctement le système d’exploitation), les fichiers journaux ne sont pas relu lors du prochain démarrage.

Note Si vous appelez CertSrvBackupTruncateLogs sans sauvegarder tous les fichiers retournés par CertSrvBackupGetDatabaseNames et CertSrvBackupGetBackupLogs, vous ne pourrez pas restaurer correctement le jeu de sauvegarde, ce qui entraîne une machine des services de certificats inutilisable. Par conséquent, appelez CertSrvBackupTruncateLogs uniquement lorsque le jeu de sauvegarde contient tous les fichiers retournés par CertSrvBackupGetDatabaseNames et CertSrvBackupGetBackupLogs.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certbcli.h (include Certsrv.h)
Bibliothèque	Certadm.lib
DLL	Certadm.dll

Voir aussi

CertSrvBackupGetBackupLogs

Utilisation des fonctions de sauvegarde et de restauration des services de certificat

Partager via