JetStopServiceInstance 함수

적용 대상: Windows | Windows Server

JetStopServiceInstance 함수

JetStopServiceInstance 함수는 종료를 위한 instance 준비합니다.

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

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

매개 변수

instance

API 호출에 사용할 실행 instance.

반환 값

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

이 함수가 성공하면 향후 종료를 준비합니다. 종료를 준비하기 위해 수행되는 단계는 다음과 같습니다.

• 실행 중인 경우 온라인 조각 모음을 중지합니다.

• 버전 저장소 클린 시작합니다.

• 버퍼 관리자에서 더티 페이지를 플러시하기 시작하여 검사점 깊이를 줄입니다.

• 해당 instance 대한 대부분의 함수에 대한 향후 호출을 방지합니다.

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

설명

이 함수는 종료될 때 instance 수행해야 하는 작업을 줄이지만 instance 종료하지는 않습니다. 따라서 이 함수는 최적화일 뿐이며 반드시 사용해야 하는 것은 아닙니다. Windows 2000 및 Windows XP에서는 준비 작업량이 적습니다. 함수가 성공하면 더 이상 허용되지 않는 함수를 호출하면 JET_errClientRequestToStopJetService 반환됩니다. 이 호출 후에도 계속 허용되는 함수는 JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase 및 JetResetSessionContext입니다.

요구 사항

참고 항목

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2