JetStopBackupInstance 함수

적용 대상: Windows | Windows Server

JetStopBackupInstance 함수

JetStopBackupInstance 함수는 스트리밍 백업 관련 작업이 특정 실행 중인 instance 계속되지 않도록 하여 스트리밍 백업을 예측 가능한 방식으로 종료합니다.

Windows XP:JetStopBackupInstance 는 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

매개 변수

instance

API 호출에 사용할 실행 중인 instance 식별합니다.

반환 값

이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errInvalidParameter	지정된 instance 매개 변수에 잘못된 값이 있습니다(현재 실행 중인 instance 아님). Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.

이 함수가 성공하면 지정된 instance 새 스트리밍 백업 API에 실패하기 시작합니다.

이 함수가 실패하면 instance 백업 종료를 준비하는 단계가 수행되지 않으며 instance 상태가 변경되지 않습니다.

설명

백업은 일반적으로 프로세스 메커니즘 외부의 이벤트에 의해 트리거되며, 이 API를 사용하여 ESENT 애플리케이션 자체는 스트리밍 백업 API에 대한 추가 호출을 수행하여 실패합니다. 대부분의 스트리밍 백업 API는 JET_errBackupAbortByServer 실패하기 시작합니다. 따라서 스트리밍 백업 진행률(예: JetReadFileInstance)은 오류를 반환합니다. 백업 종료의 일부인 백업 작업(예: JetEndExternalBackupInstance)은 계속 허용됩니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista 또는 Windows XP가 필요합니다.
서버	Windows Server 2008 또는 Windows Server 2003이 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.

참고 항목

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService