적용 대상: Windows | Windows Server
JetOSSnapshotPrepareInstance 함수
JetOSSnapshotPrepareInstance 함수는 스냅샷 세션의 일부가 될 특정 instance 선택합니다.
Windows Vista:JetOSSnapshotPrepareInstance 가 Windows Vista에 도입되었습니다.
JET_ERR JET_API JetOSSnapshotPrepareInstance(
__in JET_OSSNAPID snapId,
__in JET_INSTANCE instance,
__in const JET_GRBIT grbit
);
매개 변수
snapId
스냅샷 세션의 식별자입니다.
instance
이 호출에 사용할 instance.
grbit
이 호출에 대한 옵션입니다. 이 매개 변수는 나중에 사용하도록 예약되어 있습니다. 유효한 값은 0입니다.
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errInvalidParameter |
스냅샷 ID 포인터가 NULL이거나 grbit 매개 변수가 잘못되었습니다. |
JET_errOSSnapshotInvalidSequence |
스냅샷 세션이 이미 진행 중입니다. |
JET_errOSSnapshotInvalidSnapId |
스냅샷 세션의 식별자가 잘못되었습니다. |
이 함수가 성공하면 지정된 instance 스냅샷 세션의 일부가 됩니다.
이 함수가 실패하면 엔진 상태가 변경되지 않습니다.
설명
일반적인 API 시퀀스 호출은 JetOSSnapshotPrepare이며, 필요에 따라 JetOSSnapshotPrepareInstance에 대해 하나 이상의 호출을 수행한 다음 JetOSSnapshotFreeze를 호출합니다. 동결이 시작되면 JetOSSnapshotThaw를 사용하여 종료할 수 있습니다. 준비 후 언제든지 JetOSSnapshotAbort를 사용하여 스냅샷 세션을 갑자기 종료할 수 있습니다. 이벤트 로그 항목은 스냅샷 다양한 단계에 대해 생성됩니다.
JetOSSnapshotPrepareInstance가 세션 시작(JetOSSnapshotPrepare)과 중지 순간(JetOSSnapshotFreeze) 사이에 호출되지 않으면 엔진의 모든 실행 중인 인스턴스가 중지되고 스냅샷 세션의 일부가 됩니다. 이 문제는 두 가지 이유로 발생합니다.
모든 인스턴스를 원하는 사용자의 코드를 간소화합니다.
스냅샷 API의 호출자에 대한 이전 버전과의 호환성을 허용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista가 필요합니다. |
서버 |
Windows Server 2008이 필요합니다. |
머리글 |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
참고 항목
매개 변수 처리 오류
확장 가능한 스토리지 엔진 오류
JET_ERR
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw