JetOSSnapshotPrepareInstance 함수

아티클
06/13/2023

적용 대상: 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

다음을 통해 공유

JetOSSnapshotPrepareInstance 함수