Fungsi FhServiceStartBackup (fhsvcctl.h)

Fungsi ini memulai pencadangan langsung untuk pengguna saat ini.

Catatan

FhServiceStartBackup tidak digunakan lagi dan dapat diubah atau tidak tersedia dalam rilis mendatang.

Sintaks

HRESULT FhServiceStartBackup(
  [in] FH_SERVICE_PIPE_HANDLE Pipe,
  [in] BOOL                   LowPriorityIo
);

Parameter

[in] Pipe

Handel saluran komunikasi yang dikembalikan oleh panggilan FhServiceOpenPipe sebelumnya.

[in] LowPriorityIo

Jika TRUE, Layanan Riwayat File diinstruksikan untuk menggunakan I/O prioritas rendah untuk pencadangan langsung yang dijadwalkan oleh fungsi ini. I/O berprioritas rendah mengurangi dampak pada aktivitas pengguna latar depan. Disarankan untuk mengatur parameter ini ke TRUE.

Jika FALSE, Layanan Riwayat File diinstruksikan untuk menggunakan I/O prioritas normal untuk pencadangan langsung yang dijadwalkan oleh fungsi ini. Ini menghasilkan pencadangan yang lebih cepat tetapi berdampak negatif pada responsivitas dan performa aplikasi pengguna.

Mengembalikan nilai

S_OK pada keberhasilan, atau HRESULT yang gagal pada kegagalan. Kemungkinan nilai HRESULT yang gagal menyertakan nilai yang ditentukan dalam file header FhErrors.h.

Keterangan

Fungsi ini tidak menunggu sampai pencadangan langsung selesai. Jika terjadi kesalahan atau kondisi peringatan selama pencadangan, itu dikomunikasikan kepada pengguna melalui pemberitahuan Pusat Tindakan dan dapat diambil secara terprogram melalui metode IFhConfigMgr::QueryProtectionStatus .

Siklus cadangan yang dimulai dengan memanggil fungsi ini dapat dihentikan menggunakan fungsi FhServiceStopBackup .

Persyaratan

Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	fhsvcctl.h
Pustaka	FhSvcCtl.lib

Lihat juga

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus