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 函式來停止。