Fungsi CertSrvRestoreRegisterThroughFile (certbcli.h)

  • Artikel

Fungsi CertSrvRestoreRegisterThroughFile mendaftarkan pemulihan Layanan Sertifikat.

Sintaks

HRESULT CERTBCLI_API CertSrvRestoreRegisterThroughFile(
  [in]           HCSBC            hbc,
  [in, optional] WCHAR const      *pwszCheckPointFilePath,
  [in, optional] WCHAR const      *pwszLogPath,
  [in, optional] CSEDB_RSTMAPW [] rgrstmap,
  [in]           LONG             crstmap,
  [in, optional] WCHAR const      *pwszBackupLogPath,
  [in]           ULONG            genLow,
  [in]           ULONG            genHigh
);

Parameter

[in] hbc

Handel ke konteks pemulihan Layanan Sertifikat. Handel ini diperoleh dengan memanggil fungsi CertSrvRestorePrepare .

[in, optional] pwszCheckPointFilePath

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur pemulihan untuk file titik pemeriksaan. Teruskan NULL untuk parameter ini jika tidak diperlukan.

[in, optional] pwszLogPath

Penunjuk ke string Unicode yang dihentikan null yang berisi direktori file log saat ini. Teruskan NULL untuk parameter ini jika tidak diperlukan.

[in, optional] rgrstmap

Array struktur CSEDB_RSTMAP yang berisi peta pemulihan. Jika Anda melakukan pemulihan database lengkap, parameter ini menentukan nama database cadangan, serta nama baru untuk database setelah dipulihkan. Nama database cadangan dirujuk oleh anggota pwszDatabaseName , dan nama database baru dirujuk oleh anggota pwszNewDatabaseName . Jika niatnya adalah mempertahankan nama yang sama untuk database cadangan dan database yang dipulihkan, atur pwszNewDatabaseName dan anggota pwszDatabaseName ke nama yang sama. Nama database cadangan dibangun dari jalur yang dikembalikan oleh panggilan klien cadangan ke fungsi CertSrvRestoreGetDatabaseLocations . CertSrvRestoreGetDatabaseLocations akan dipanggil selama pencadangan penuh, dan klien cadangan akan menyimpan jalur yang dikembalikan.

Jika Anda melakukan pemulihan inkremental, atur parameter ini ke NULL.

[in] crstmap

Jumlah elemen dalam array rgrstmap . Atur nilai ini ke nilai jika Anda melakukan pemulihan penuh, atau nol jika Anda melakukan pemulihan inkremental.

[in, optional] pwszBackupLogPath

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur untuk direktori log cadangan. Teruskan NULL untuk parameter ini jika tidak diperlukan.

[in] genLow

Nomor log terendah yang dipulihkan dalam sesi pemulihan ini. File log dalam bentuk edbXXXXX.log, di mana XXXXX adalah nilai lima digit heksadesimal. Misalnya, edb00001.log adalah file log pertama yang dibuat oleh database internal. Untuk tujuan fungsi ini, nilai satu dalam genLow sesuai dengan file log edb00001.log.

[in] genHigh

Nomor log tertinggi yang dipulihkan dalam sesi pemulihan ini.

Menampilkan nilai

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan.

Keterangan

Fungsi ini identik dengan fungsi CertSrvRestoreRegister kecuali bahwa CertSrvRestoreRegister mengharuskan akun panggilan menjadi administrator lokal. Fungsi CertSrvRestoreRegisterThroughFile hanya mengharuskan akun panggilan memiliki hak istimewa pemulihan.

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

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat