Fungsi DsBackupGetDatabaseNames

[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 DsBackupGetDatabaseNames mendapatkan daftar file database yang akan dicadangkan untuk konteks pencadangan yang diberikan.

Sintaks

HRESULT DsBackupGetDatabaseNames(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszAttachmentInfo,
  _Out_ LPDWORD pcbSize
);

Parameter

hbc [in]

Berisi handel konteks cadangan yang diperoleh dengan fungsi DsBackupPrepare .

pszAttachmentInfo [out]

Penunjuk ke penunjuk string yang menerima daftar nama file database sebagai jalur UNC. Nilai ini harus diinisialisasi ke NULL sebelum memanggil DsBackupGetDatabaseNames.

Daftar ini menerima daftar dua kali null-dihentikan dari string tunggal yang dihentikan null.

Buffer ini dialokasikan oleh fungsi DsBackupGetDatabaseNames dan harus dikosongkan ketika tidak lagi diperlukan dengan memanggil fungsi DsBackupFree .

Karakter pertama dari setiap nama file berisi salah satu Konstanta BFT yang mengidentifikasi jenis nama. Fungsi DsRestoreGetDatabaseLocations hanya menyediakan jenis nama berikut.

BFT_NTDS_DATABASE

File adalah file database NTDS. File ini harus disalin ke file yang diidentifikasi sebagai BFT_NTDS_DATABASE ketika data dipulihkan.

BFT_LOG

File adalah file log. Semua file log disalin ke direktori yang diidentifikasi sebagai BFT_LOG_DIR saat data dipulihkan.

BFT_PATCH_FILE

File adalah file patch. Semua file patch disalin ke direktori yang diidentifikasi sebagai BFT_CHECKPOINT_DIR saat data dipulihkan.

pcbSize [out]

Arahkan ke nilai DWORD yang menerima ukuran, dalam byte, dari buffer pszAttachmentInfo .

Menampilkan nilai

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

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

hbc, pszAttachmentInfo, atau pcbSize tidak valid.

ERROR_NOT_ENOUGH_MEMORY

Terjadi kegagalan alokasi memori.

Keterangan

Fungsi DsBackupGetDatabaseNames menyediakan daftar file database yang diperlukan untuk cadangan. Pencadangan penuh terdiri dari file database dan file log yang disediakan oleh fungsi DsBackupGetBackupLogs . Pencadangan inkremental server Direktori Aktif tidak didukung.

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	DsBackupGetDatabaseNamesW (Unicode) dan DsBackupGetDatabaseNamesA (ANSI)

Lihat juga

DsBackupPrepare

DsBackupFree

DsBackupGetBackupLogs

Konstanta BFT

Mencadangkan Server Direktori Aktif

Fungsi Pencadangan Direktori