적용 대상: 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 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errInvalidParameter |
지정된 instance 매개 변수에 잘못된 값이 있습니다(현재 실행 중인 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 Server 2008 또는 Windows Server 2003이 필요합니다. |
머리글 |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
참고 항목
JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2