Fungsi DsRestoreRegister

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Dimulai dengan Windows Vista, gunakan Layanan Menyalin Bayangan Volume (VSS) sebagai gantinya.]

Fungsi DsRestoreRegister mendaftarkan operasi pemulihan. Fungsi ini menginterlock semua operasi pemulihan berikutnya dan mencegah target pemulihan dimulai hingga fungsi DsRestoreRegisterComplete dipanggil.

Sintaks

HRESULT DsRestoreRegister(
  _In_ HBC        hbc,
  _In_ LPCTSTR    szCheckPointFilePath,
  _In_ LPCTSTR    szLogPath,
  _In_ EDB_RSTMAP rgrstmap[],
  _In_ LONG       crstmap,
  _In_ LPCTSTR    szBackupLogPath,
  _In_ ULONG      genLow,
  _In_ ULONG      genHigh
);

Parameter

hbc [in]

Berisi handel konteks pemulihan yang diperoleh dengan fungsi DsRestorePrepare .

szCheckPointFilePath [in]

Penunjuk ke string yang dihentikan null yang berisi jalur ke file titik pemeriksaan. Jalur ini disediakan oleh fungsi DsRestoreGetDatabaseLocations dan memiliki nilai BFTBFT_CHECKPOINT_DIR. Biasanya ini sama dengan jalur database sistem. Jalur ini diperlukan untuk fungsi pemulihan cadangan yang tepat. Parameter ini tidak boleh NULL. Melewati NULL dalam parameter ini akan menyebabkan kesalahan selama proses pemulihan.

szLogPath [in]

Penunjuk ke string yang dihentikan null yang berisi jalur tempat file log akan dipulihkan. Jalur ini disediakan oleh fungsi DsRestoreGetDatabaseLocations dan memiliki nilai BFTBFT_LOG_DIR. Jika jalur menunjuk ke direktori kosong, file log baru dibuat di sana. Parameter ini tidak boleh NULL.

rgrstmap [in]

Array struktur EDB_RSTMAP yang berisi jalur lama dan baru untuk setiap database. Ada satu struktur untuk setiap database. Untuk direktori, ada struktur untuk database sistem dan struktur lain untuk database direktori. Urutan elemen dalam array tidak masalah. Parameter crstmap berisi jumlah elemen dalam array.

crstmap [in]

Berisi jumlah elemen dalam array rgrstmap .

szBackupLogPath [in]

Penunjuk ke string yang dihentikan null yang berisi jalur tempat file log yang dicadangkan saat ini berada. Parameter ini tidak boleh NULL.

genLow [in]

Berisi nomor log terendah untuk dipulihkan dalam sesi pemulihan ini. Ini adalah angka heksadesimal dalam rentang dari 0x00000 hingga 0xFFFFF.

genHigh [in]

Berisi nomor log tertinggi untuk dipulihkan dalam sesi pemulihan ini. Ini adalah angka heksadesimal dalam rentang dari 0x00000 hingga 0xFFFFF.

Menampilkan nilai

Mengembalikan S_OK jika fungsi berhasil atau kode kesalahan Win32 atau RPC sebaliknya. Daftar berikut mencantumkan kemungkinan kode kesalahan.

ERROR_ACCESS_DENIED

Pemanggil tidak memiliki hak akses yang tepat untuk memanggil fungsi ini. Fungsi DsSetAuthIdentity dapat digunakan untuk mengatur kredensial yang akan digunakan untuk fungsi pencadangan dan pemulihan.

ERROR_INVALID_PARAMETER

Satu atau beberapa parameter tidak valid.

hrMissingExpiryToken

Token kedaluwarsa yang diberikan ke DsRestorePrepare tidak valid. Nilai ini ditentukan dalam Ntdsbmsg.h.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Ntdsbcli.h
Pustaka	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Nama Unicode dan ANSI	DsRestoreRegisterW (Unicode) dan DsRestoreRegisterA (ANSI)

Lihat juga

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

Memulihkan Direktori Aktif

Fungsi Pencadangan Direktori