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.
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
-
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.
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 | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Header |
|
Pustaka |
|
DLL |
|