JetOSSnapshotPrepare 함수
적용 대상: Windows | Windows Server
JetOSSnapshotPrepare 함수는 스냅샷 세션에 대한 준비를 시작합니다. 스냅샷 세션은 엔진이 디스크에 쓰기 IO를 발급하지 않는 짧은 시간 간격이므로 엔진이 볼륨 스냅샷 세션(스냅샷 기록기에 의해 구동되는 경우)에 참여할 수 있습니다.
Windows XP:JetOSSnapshotPrepare 는 Windows XP에 도입되었습니다.
JET_ERR JET_API JetOSSnapshotPrepare(
__out JET_OSSNAPID* psnapId,
__in const JET_GRBIT grbit
);
psnapId
시작할 스냅샷 세션의 식별자입니다.
grbit
이 호출에 대한 옵션입니다. 이 매개 변수에는 다음 값의 조합이 있을 수 있습니다.
값 |
의미 |
|---|---|
0 |
일반 스냅샷. |
JET_bitIncrementalSnapshot |
로그 파일만 가져옵니다. |
JET_bitCopySnapshot |
로그 잘림이 없는 복사 스냅샷(일반 또는 증분)입니다. |
JET_bitContinueAfterThaw |
스냅샷 세션은 JetOSSnapshotThaw 후에 발생하며 JetOSSnapshotEnd 함수 호출이 필요합니다. |
JET_bitExplicitPrepare |
인스턴스는 기본적으로 준비되지 않습니다. Windows 7: JET_bitExplicitPrepare Windows 7에 도입되었습니다. |
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errInvalidParameter |
스냅샷 ID 포인터가 NULL이거나 grbit 매개 변수가 잘못되었습니다. |
JET_errOSSnapshotInvalidSequence |
스냅샷 세션이 이미 진행 중이며 작업이 지정된 시간에 둘 이상의 스냅샷 세션을 가질 수 없습니다. |
이 함수가 성공하면 스냅샷 세션은 언제든지 IO 중지 단계로 시작할 수 있습니다. 세션의 식별자가 반환되며 스냅샷 세션에 대한 후속 호출에서 사용해야 합니다.
이제 엔진의 실행 중인 인스턴스가 스냅샷 세션의 일부로 간주됩니다.
Windows Vista: 다른 인스턴스 하위 집합을 지정하기 위해 JetOSSnapshotPrepareInstance 를 호출할 수 있습니다.
일반적인 API 시퀀스 호출은 JetOSSnapshotPrepare이며, 필요에 따라 JetOSSnapshotPrepareInstance에 대한 하나 이상의 호출이 뒤에 잇고 JetOSSnapshotFreeze가 뒤따릅니다. 동결이 시작되면 JetOSSnapshotThaw를 사용하여 종료할 수 있습니다. 준비 후 언제든지 JetOSSnapshotAbort를 사용하여 스냅샷 세션을 갑자기 종료할 수 있습니다.
JetOSSnapshotThaw 이후에 JET_bitContinueAfterThaw 지정되면 스냅샷 세션이 다시 시작됩니다기본(I/O가 다시 시작되더라도). 이렇게 하면 스냅샷 확인이 가능하며 필요한 경우 JetOSSnapshotTruncateLog를 사용하여 로그 잘림을 사용하도록 설정하고 JetOSSnapshotEnd에 대한 호출이 필요합니다.
이 함수가 실패하면 엔진 상태가 변경되지 않습니다.
이벤트 로그 항목은 스냅샷 여러 단계에 대해 생성됩니다.
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista 또는 Windows XP가 필요합니다. |
서버 |
Windows Server 2008 또는 Windows Server 2003이 필요합니다. |
Header |
Esent.h에서 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
Dll |
ESENT.dll이 필요합니다. |
JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog