다음을 통해 공유


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를 사용하도록 지시됩니다. 이로 인해 백업 속도가 빨라지지만 사용자 애플리케이션의 응답성과 성능에 부정적인 영향을 줍니다.

반환 값

성공 또는 실패 시 실패한 HRESULT에 대한 S_OK. 실패한 HRESULT 값에는 FhErrors.h 헤더 파일에 정의된 값이 포함됩니다.

설명

이 함수는 즉시 백업이 완료될 때까지 기다리지 않습니다. 백업 중에 오류 또는 경고 조건이 발생하면 알림 센터 알림을 통해 사용자에게 전달되고 IFhConfigMgr::QueryProtectionStatus 메서드를 통해 프로그래밍 방식으로 검색할 수 있습니다.

이 함수를 호출하여 시작한 백업 주기는 FhServiceStopBackup 함수를 사용하여 중지할 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fhsvcctl.h
라이브러리 FhSvcCtl.lib

추가 정보

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus