Fungsi DsBackupRead

[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 DsBackupRead membaca blok data dari file terbuka saat ini, ke dalam buffer. Aplikasi klien diharapkan untuk memanggil fungsi ini berulang kali sampai seluruh file cadangan diterima. Fungsi DsBackupOpenFile menyediakan seluruh ukuran file cadangan.

Sintaks

HRESULT DsBackupRead(
  _In_  HBC    hbc,
  _In_  PVOID  pvBuffer,
  _In_  DWORD  cbBuffer,
  _Out_ PDWORD pcbRead
);

Parameter

hbc [in]

Berisi handel konteks cadangan yang diperoleh dengan fungsi DsBackupPrepare .

pvBuffer [in]

Penunjuk ke buffer yang menerima data. Buffer ini harus berukuran setidaknya cbBuffer byte.

cbBuffer [in]

Berisi ukuran, dalam byte, dari buffer di pvBuffer. Nilai ini harus kelipatan 8192 dan harus lebih besar dari atau sama dengan 24576.

pcbRead [out]

Penunjuk ke nilai DWORD yang menerima jumlah byte aktual yang dibaca. Ini mungkin kurang dari jumlah byte yang diminta karena beberapa transportasi memecah buffer yang dikirimkan alih-alih mengisi seluruh buffer dengan data.

Menampilkan nilai

Mengembalikan S_OK jika fungsi berhasil atau kode kesalahan Win32 atau RPC sebaliknya. Kemungkinan kode kesalahan termasuk yang berikut ini.

ERROR_INVALID_PARAMETER

Satu atau beberapa parameter tidak valid.

ERROR_HANDLE_EOF

Akhir file cadangan tercapai.

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

Lihat juga

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Mencadangkan Server Direktori Aktif

Fungsi Pencadangan Direktori