Fungsi CertSrvBackupGetBackupLogsW (certbcli.h)

Artikel
23/02/2024

Fungsi CertSrvBackupGetBackupLogs mengambil daftar nama file log Layanan Sertifikat yang perlu dicadangkan untuk konteks pencadangan yang diberikan.

Sintaks

HRESULT CERTBCLI_API CertSrvBackupGetBackupLogsW(
  [in]  HCSBC hbc,
  [out] PWSTR *ppwszzBackupLogFiles,
  [out] DWORD *pcbSize
);

Parameter

[in] hbc

Handel ke konteks pencadangan Layanan Sertifikat.

[out] ppwszzBackupLogFiles

Penunjuk ke penunjuk WCHAR yang akan menerima daftar nama file log yang dihentikan null. Ada karakter null setelah setiap nama file dan karakter null ekstra di akhir daftar. Nama file akan berada dalam bentuk UNC "## \\Server\SharePoint\... Jalur...\FileName.ext". Nama direktori akan memiliki formulir yang sama tetapi tanpa "\FileName.ext" berikutnya. Teks "##" menunjukkan jenis file Cadangan Layanan Sertifikat (CSBFT_*) dan disimpan sebagai karakter Unicode non-null tunggal yang diawali ke setiap jalur UNC. Tag jenis ini didefinisikan dalam Certbcli.h dan dapat menjadi salah satu nilai berikut untuk fungsi ini.

Nilai	Makna
CSBFT_LOG	Nama file log database Certificate Services termasuk jalur.
CSBFT_PATCH_FILE	Nama, termasuk jalur, file pembaruan untuk database Layanan Sertifikat. Windows Server 2003: File pembaruan database tidak digunakan.

Setelah Anda selesai menggunakan memori yang dialokasikan ini, bebaskan dengan memanggil fungsi CertSrvBackupFree .

Mengatur ppwszzBackupLogFiles ke NULL sebelum memanggil fungsi ini bersifat opsional.

[out] pcbSize

Penunjuk ke nilai DWORD yang menentukan jumlah byte dalam ppwszzBackupLogFiles.

Nilai kembali

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan.

Keterangan

File log mewakili aktivitas database (pengiriman permintaan, pencabutan sertifikat, dan sebagainya) yang telah terjadi sejak pemotokan file log terakhir. Volume file log meningkat saat aktivitas database terjadi. Ukuran file log dapat dikurangi dengan melakukan pencadangan lalu memanggil CertSrvBackupTruncateLogs.

Nama fungsi ini dalam Certadm.dll adalah CertSrvBackupGetBackupLogsW. Anda harus menggunakan bentuk nama ini saat memanggil GetProcAddress. Selain itu, fungsi ini didefinisikan sebagai jenis FNCERTSRVBACKUPGETBACKUPLOGSW dalam file header Certbcli.h.

Contoh

FNCERTSRVBACKUPGETBACKUPLOGSW* pfnGetBackupLogs;
char * szGetBackupLogsFunc = "CertSrvBackupGetBackupLogsW";

WCHAR *    pwszzLogFiles;

DWORD      nListBytes=0;

HRESULT    hr=0;

// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnGetBackupLogs = (FNCERTSRVBACKUPGETBACKUPLOGSW*)GetProcAddress
    (hInst, szGetBackupLogsFunc);
if ( NULL == pfnGetBackupLogs )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szGetBackupLogsFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Determine the names of the log files.
// hCSBC was set by an earlier call to CertSrvbackupPrepare.
hr = pfnGetBackupLogs(hCSBC, &pwszzLogFiles, &nListBytes);
if (FAILED(hr))
{
    printf("Failed pfnGetBackupLogs call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}
else
{
    printf("%d bytes for log file names\n", nListBytes);
    WCHAR * pwszLog = pwszzLogFiles;
    // Process the list.
    while ( L'\0' != *pwszLog )
    {
        // Use the file name referenced by pwszLog.
        // Here it is merely displayed.
        printf("%02x: %ws\n", *pwszLog, &pwszLog[1]);
        // Move to the next logfile name.
        // + 1 moves past the null terminator.
        pwszLog+=(wcslen(pwszLog)) + 1; 
    }

    // Free the allocated memory.
    // pfnBackupFree is the address of the CertSrvBackupFree
	   // function.
    pfnBackupFree(pwszzLogFiles);
}

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