FhServiceStartBackup 函数 (fhsvcctl.h)

此函数为当前用户启动即时备份。

注意

FhServiceStartBackup 已弃用，将来的版本可能会更改或不可用。

语法

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

[in] Pipe

早期 FhServiceOpenPipe 调用返回的通信通道句柄。

[in] LowPriorityIo

如果 为 TRUE，则指示文件历史记录服务对此函数安排的即时备份使用低优先级 I/O。低优先级 I/O 可减少对前台用户活动的影响。建议将此参数设置为 TRUE。

如果 为 FALSE，则指示文件历史记录服务对此函数安排的即时备份使用正常优先级 I/O。这可以加快备份速度，但会对用户应用程序的响应能力和性能产生负面影响。

成功时S_OK ，或失败时不成功的 HRESULT 。可能不成功的 HRESULT 值包括 FhErrors.h 头文件中定义的值。

此函数不会等到立即备份完成。如果在备份过程中遇到错误或警告条件，则会通过操作中心通知将其传达给用户，并通过 IFhConfigMgr：：QueryProtectionStatus 方法以编程方式进行检索。

可以使用 FhServiceStopBackup 函数停止通过调用此函数启动的备份周期。