Fungsi DsBackupOpenFile

[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 DsBackupOpenFile membuka file yang ditentukan dan melakukan operasi klien dan server yang diperlukan untuk menyiapkan file untuk pencadangan.

Sintaks

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

Parameter

hbc [in]

Berisi handel konteks cadangan yang diperoleh dengan fungsi DsBackupPrepare .

szAttachmentName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama file cadangan yang akan dibuka.

cbReadHintSize [in]

Berisi kemungkinan ukuran, dalam byte, dari buffer yang diteruskan sebagai argumen pvBuffer dalam fungsi DsBackupRead . Fungsi pencadangan menggunakan nilai ini sebagai petunjuk untuk mengoptimalkan lalu lintas jaringan. Nilai ini harus kelipatan 8192 dan harus lebih besar dari atau sama dengan 24576.

pliFileSize [out]

Penunjuk ke nilai LARGE_INTEGER yang menerima ukuran, dalam byte, dari file cadangan yang dibuka.

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, szAttachmentName, atau pliFileSize tidak valid.

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	DsBackupOpenFileW (Unicode) dan DsBackupOpenFileA (ANSI)

Lihat juga

DsBackupRead

Mencadangkan Server Direktori Aktif

Fungsi Pencadangan Direktori