Fungsi DsRestorePrepare

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

Fungsi DsRestorePrepare tersambung ke server direktori yang ditentukan dan menyiapkannya untuk operasi pemulihan.

Sintaks

HRESULT DsRestorePrepare(
  _In_  LPCWSTR szServerName,
  _In_  ULONG   rtFlag,
  _In_  PVOID   pvExpiryToken,
  _In_  DWORD   cbExpiryTokenSize,
  _Out_ HBC     *phbc
);

Parameter

szServerName [in]

Penunjuk ke string yang dihentikan null yang berisi nama server yang akan dipulihkan. Garis miring terbalik sebelumnya bersifat opsional. Server harus merupakan komputer yang sama dengan asal fungsi ini. Nama server tidak boleh berisi karakter garis bawah (_). Contoh nama server adalah "\\server1".

rtFlag [in]

Menentukan jenis pemulihan yang akan dilakukan. Ini bisa nol atau salah satu nilai berikut.

RESTORE_TYPE_CATCHUP

Default. Versi yang dipulihkan direkonsiliasi melalui logika rekonsiliasi standar sehingga DIT yang dipulihkan dapat disinkronkan dengan komputer server perusahaan lainnya.

RESTORE_TYPE_AUTHORATATIVE

Tidak didukung.

RESTORE_TYPE_ONLINE

Tidak didukung. Pemulihan dilakukan ketika NTDS online.

pvExpiryToken [in]

Arahkan ke token kedaluwarsa yang terkait dengan cadangan yang sedang dipulihkan. Token ini diperoleh dari fungsi DsBackupPrepare ketika direktori dicadangkan.

Jika parameter ini NULL, handel yang dikembalikan dalam phbc hanya dapat digunakan untuk mendapatkan direktori pemulihan dengan fungsi DsRestoreGetDatabaseLocations . Handel tidak dapat digunakan untuk fungsi pemulihan lainnya.

cbExpiryTokenSize [in]

Berisi ukuran, dalam byte, dari token kedaluwarsa di pvExpiryToken.

phbc [out]

Penunjuk ke nilai HBC yang menerima handel untuk pemulihan. Handel ini digunakan saat memanggil fungsi pemulihan Layanan Direktori lainnya, seperti DsBackupOpenFile dan DsRestoreEnd.

Nilai kembali

Jika berhasil, mengembalikan kode HRESULT standar; jika tidak, kode kegagalan dikembalikan.

Keterangan

Fungsi DsRestorePrepare mengharuskan pemanggil adalah anggota grup Administrator di server.

DsRestorePrepare dapat digunakan dengan atau tanpa token yang disediakan. Jika token disediakan, token diperiksa untuk kedaluwarsa, dan semua operasi diizinkan pada konteks yang dikembalikan. Jika token tidak disediakan, konteks yang dikembalikan dibatasi, dan hanya dapat digunakan untuk fungsi DsRestoreGetDatabaseLocations . Ini mungkin tidak digunakan untuk fungsi DsRestoreRegister .

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	DsRestorePrepareW (Unicode) dan DsRestorePrepareA (ANSI)

Lihat juga

Memulihkan Server Direktori Aktif

Fungsi Pencadangan Direktori

DsRestoreGetDatabaseLocations

DsRestoreRegister

DsRestoreRegisterComplete

DsRestoreEnd