JetOSSnapshotPrepare 함수

아티클
12/06/2023

적용 대상: Windows | Windows Server

JetOSSnapshotPrepare 함수

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에 도입되었습니다.

Return Value

이 함수는 다음 반환 코드 중 하나를 사용하여 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

다음을 통해 공유

JetOSSnapshotPrepare 함수