JetStopService 함수

적용 대상: Windows | Windows Server

JetStopService 함수

JetStopService 함수는 종료할 instance 준비합니다.

JetStopService는 instance 하나만 허용되는 레거시 호출입니다. 이 경우 유일한 활성 instance 종료를 준비하는 것입니다.

    JET_ERR JET_API JetStopService(void);

매개 변수

이 함수에는 매개 변수가 없습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errRunningInMultiInstanceMode	여러 instance 모드로 JetStopService를 사용할 때 종료를 준비할 instance 명확하지 않습니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.

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

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

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

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

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

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

설명

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

요구 사항

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

참고 항목

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2