Fungsi DsBackupPrepare
[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 DsBackupPrepare menyiapkan direktori pada server yang ditentukan untuk pencadangan online dan mengembalikan handel konteks cadangan yang digunakan dalam panggilan berikutnya ke fungsi pencadangan lainnya.
Sintaks
HRESULT DsBackupPrepare(
_In_ LPCTSTR szBackupServer,
_In_ ULONG grbit,
_In_ ULONG btBackupType,
_Out_ PVOID *ppvExpiryToken,
_Out_ LPDWORD pcbExpiryTokenSize,
_Out_ HBC *phbc
);
Parameter
-
szBackupServer [in]
-
Penunjuk ke string yang dihentikan null yang berisi nama server yang akan dicadangkan. 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".
-
grbit [in]
-
Menentukan apakah file log akan dicadangkan. Nilai ini harus selalu 0 karena pencadangan inkremental tidak didukung.
-
btBackupType [in]
-
Menentukan jenis cadangan. Ini bisa menjadi salah satu nilai berikut.
-
BACKUP_TYPE_FULL
-
Menentukan pencadangan penuh. Direktori lengkap (DIT, file log, dan file pembaruan) dicadangkan. Semua data dicadangkan dan file log transaksi dipotok. Hanya pencadangan penuh yang didukung.
-
BACKUP_TYPE_LOGS_ONLY
-
Nilai ini tidak didukung. Menentukan bahwa hanya log database, dan bukan database itu sendiri, yang akan dicadangkan. Ini biasanya digunakan saat melakukan pencadangan diferensial atau inkremental.
-
BACKUP_TYPE_INCREMENTAL
-
Nilai ini tidak didukung. DsBackupPrepare mengembalikan ERROR_INVALID_PARAMETER.
ppvExpiryToken [out]
Penunjuk ke nilai PVOID yang menerima pointer ke token kedaluwarsa yang terkait dengan cadangan ini. pcbExpiryTokenSize menerima ukuran, dalam byte, dari data ini. Pemanggil harus menyimpan konten token ini dengan cadangan karena token harus diteruskan ke DsRestorePrepare saat mencoba memulihkan data. Setelah token disimpan dan tidak lagi diperlukan, pemanggil harus membebaskan memori yang dialokasikan menggunakan DsBackupFree.
pcbExpiryTokenSize [out]
Penunjuk ke nilai DWORD yang menerima ukuran, dalam byte, dari token di ppvExpiryToken.
phbc [out]
Penunjuk ke nilai HBC yang menerima handel untuk cadangan. Handel ini digunakan saat memanggil fungsi pencadangan Layanan Direktori lainnya, seperti DsBackupOpenFile dan DsBackupEnd.
Menampilkan nilai
Mengembalikan S_OK jika fungsi berhasil atau kode kesalahan sebaliknya. Daftar berikut mencantumkan kemungkinan kode kesalahan lainnya.
-
ERROR_ACCESS_DENIED
-
Penelepon 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
-
szBackupServer atau phbcBackupContext tidak valid.
-
ERROR_NOT_ENOUGH_MEMORY
-
Terjadi kegagalan alokasi memori.
-
hrCouldNotConnect
-
Server di szBackupServer tidak dapat ditemukan, bukan pengendali domain atau szBackupServer tidak diformat dengan benar. Nilai ini didefinisikan dalam ntdsbmsg.h.
-
hrInvalidParam
-
ppvExpiryToken dan/atau pcbExpiryTokenSize tidak valid. Nilai ini didefinisikan dalam Ntdsbmsg.h.
-
RPC_S_INVALID_BINDING
-
Fungsi ini dipanggil dari jarak jauh atau server di szServerName bukan pengendali domain.
Keterangan
Fungsi ini mengharuskan penelepon memiliki hak istimewa SE_BACKUP_NAME . Fungsi DsSetAuthIdentity dapat digunakan untuk mengubah konteks keamanan di mana fungsi ini dipanggil.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Header |
|
| Pustaka |
|
| DLL |
|
| Nama Unicode dan ANSI |
DsBackupPrepareW (Unicode) dan DsBackupPrepareA (ANSI) |