Fungsi CertSrvBackupTruncateLogs (certbcli.h)

Fungsi CertSrvBackupTruncateLogs menghilangkan rekaman yang berlebihan dan mengurangi ruang penyimpanan disk yang digunakan oleh file log. Sebelum memotong file log, pastikan bahwa cadangan semua file yang dikembalikan oleh CertSrvBackupGetDatabaseNames dan CertSrvBackupGetBackupLogs telah diamankan.

Sintaks

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

Parameter

[in] hbc

Handel ke konteks pencadangan Layanan Sertifikat.

Nilai kembali

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan.

Keterangan

Setelah mengamankan cadangan database dan file log, file log secara opsional dapat dipotong. Volume file log meningkat dengan aktivitas database, dan memotong file log akan mengurangi rekaman redundan dalam file log (sehingga mengurangi ruang disk yang digunakan untuk menyimpan file log).

File log disediakan untuk integritas dan efisiensi database. Jika keluar kurang dari anggun terjadi dengan aplikasi Layanan Sertifikat, lain kali Layanan Sertifikat dimulai, database memutar ulang file log untuk mencegah kerusakan data diperkenalkan ke dalam database.

Bergantung pada volume file log, pemutaran ulang file log dapat menjadi proses yang memakan waktu. Selama pemutaran ulang ini, otoritas sertifikasi tidak akan tersedia untuk aktivitas lain. Perhatikan bahwa jika aplikasi Layanan Sertifikat dihentikan dengan benar (seperti dengan menghentikan layanan atau dengan mematikan sistem operasi dengan benar), file log tidak diputar ulang saat berikutnya dimulai.

Catatan Jika Anda memanggil CertSrvBackupTruncateLogs tanpa mencadangkan semua file yang dikembalikan dari CertSrvBackupGetDatabaseNames dan CertSrvBackupGetBackupLogs, Anda tidak akan dapat memulihkan kumpulan cadangan dengan sukses, menghasilkan mesin Layanan Sertifikat yang tidak dapat digunakan. Oleh karena itu, panggil CertSrvBackupTruncateLogs hanya ketika kumpulan cadangan berisi semua file yang dikembalikan dari CertSrvBackupGetDatabaseNames dan CertSrvBackupGetBackupLogs.

 

Contoh

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	certbcli.h (termasuk Certsrv.h)
Pustaka	Certadm.lib
DLL	Certadm.dll

Lihat juga

CertSrvBackupGetBackupLogs

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat