Fungsi CertSrvBackupPrepareW (certbcli.h)

Artikel
02/28/2024

Fungsi CertSrvBackupPrepare digunakan untuk menyiapkan server Layanan Sertifikat untuk operasi pencadangan.

Sintaks

HRESULT CERTBCLI_API CertSrvBackupPrepareW(
  [in]  WCHAR const *pwszServerName,
  [in]  ULONG       grbitJet,
  [in]  ULONG       dwBackupFlags,
  [out] HCSBC       *phbc
);

Parameter

[in] pwszServerName

Penunjuk ke nama komputer server untuk mempersiapkan pencadangan online. Nama ini bisa menjadi nama NetBIOS atau nama DNS.

[in] grbitJet

Nilai yang digunakan oleh mesin database; nilai ini harus diatur ke nol.

[in] dwBackupFlags

Menentukan jenis cadangan. Ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CSBACKUP_TYPE_FULL	Cadangkan database Layanan Sertifikat, log, dan file terkait.
CSBACKUP_TYPE_LOGS_ONLY	Cadangkan file log saja.

[out] phbc

Penunjuk ke handel konteks pencadangan Layanan Sertifikat (HCSBC).

Mengembalikan nilai

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan, dan *phbc akan diatur ke HCSBC yang dapat digunakan oleh API cadangan Layanan Sertifikat lainnya.

Keterangan

Sebelum pencadangan Layanan Sertifikat dapat terjadi, perlu untuk membuat HCSBC melalui CertSrvBackupPrepare. HCSBC yang dihasilkan adalah parameter fungsi cadangan Layanan Sertifikat yang diperlukan yang dapat digunakan untuk mencantumkan, membuka, membaca, dan menutup file, serta memotong file log.

Catatan Ketika sesi pencadangan selesai, perlu untuk memanggil CertSrvBackupEnd untuk merilis HCSBC yang dihasilkan dari panggilan ke CertSrvBackupPrepare.

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

Untuk menjalankan panggilan ini, Anda harus memiliki hak istimewa cadangan. Untuk detailnya, lihat Mengatur Hak Istimewa Pencadangan dan Pemulihan.

Contoh

WCHAR *    wszServer = L"MyCertServerMachine";
FNCERTSRVBACKUPPREPAREW* pfnBackupPrepare;
char * szBackPrepFunc = "CertSrvBackupPrepareW";
HINSTANCE  hInst=0;
HCSBC      hCSBC=NULL;
HRESULT    hr=0;

// Load the DLL.
hInst = LoadLibrary(L"Certadm.dll");
if ( NULL == hInst )
{
    printf("Failed LoadLibrary, error=%d\n",
            GetLastError() );
    exit(1); // Or other appropriate error action.
}
// Get the address for the desired function.
pfnBackupPrepare = (FNCERTSRVBACKUPPREPAREW*)GetProcAddress( hInst,
                                        szBackPrepFunc );
if ( NULL == pfnBackupPrepare )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szBackPrepFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Prepare CertServ for backup.
hr = pfnBackupPrepare(wszServer,
                      0,
                      CSBACKUP_TYPE_FULL,
                      &hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnBackupPrepare call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

// Use the HCSBC for backup operations.
// ...

// When done processing, release the HCSBC context
// by calling CertSrvBackupEnd (not shown here).
// ...


// Done processing, free the DLL.
if (hInst)
    FreeLibrary(hInst);

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

CertSrvBackupEnd

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat

Bagikan melalui