JetGetLogInfoInstance 함수

적용 대상: Windows | Windows Server

JetGetLogInfoInstance 함수

JetGetLogInfoInstance 함수는 JetBeginExternalBackup에서 시작한 백업 중에 사용하여 백업 파일 집합의 일부가 되어야 하는 데이터베이스 패치 파일 및 트랜잭션 로그 파일의 이름에 대한 instance 쿼리합니다. 이러한 파일은 나중에 JetOpenFile 을 사용하여 열고 JetReadFile을 사용하여 읽을 수 있습니다.

Windows XP: JetGetLogInfoInstance 가 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetGetLogInfoInstance(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

매개 변수

instance

이 호출에 사용할 instance.

Windows 2000의 경우 instance 하나만 지원되므로 이 매개 변수를 허용하는 API 변형을 사용할 수 없습니다. 이 하나의 전역 instance 사용하는 것은 이 경우에 암시됩니다.

Windows XP 이상 릴리스의 경우 이 매개 변수를 허용하지 않는 API 변형은 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에 있을 때만 호출될 수 있습니다. 그렇지 않으면 JET_errRunningInMultiInstanceMode 작업이 실패합니다.

szz

백업 파일 집합의 일부여야 하는 데이터베이스 패치 파일 및 트랜잭션 로그 파일 집합을 설명하는 null 종료 문자열 목록을 수신하는 출력 버퍼입니다.

이 버퍼에서 반환되는 문자열 목록은 레지스트리에서 사용하는 다중 문자열과 동일한 형식입니다. 종료된 각 null 문자열은 순서대로 반환되고 최종 null 종결자가 반환됩니다.

cbMax

출력 버퍼의 최대 크기(바이트)입니다.

pcbActual

출력 버퍼에서 받은 실제 문자열 데이터 양을 받습니다.

반환 값

이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errBackupAbortByServer	현재 외부 백업이 JetStopBackup 호출에 의해 중단되었기 때문에 작업이 실패했습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errClientRequestToStopJetService	JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.
JET_errInstanceUnavailable	세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.
JET_errInvalidBackupSequence	백업 작업이 시퀀스에서 호출되었기 때문에 실패했습니다. JetGetLogInfo는 instance JetOpenFile을 사용하여 만든 미해결 파일 핸들이 있는 경우 이 오류를 반환합니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 지정된 instance 핸들이 유효하지 않은 경우 JetGetLogInfo에서 이 문제가 발생할 수 있습니다(Windows XP 이상 릴리스).
JET_errNoBackup	외부 백업이 진행 중이 아니므로 작업이 실패했습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
JET_errRunningInMultiInstanceMode	실제로 여러 인스턴스가 이미 있는 경우 하나의 instance만 지원되는 레거시 모드(Windows 2000 호환 모드)에서 엔진을 사용하려고 했기 때문에 작업이 실패했습니다.
JET_errTermInProgress	세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

성공하면 백업 파일 집합의 일부여야 하는 데이터베이스 패치 파일 및 트랜잭션 로그 파일 집합에 대한 요청된 정보가 제공된 출력 버퍼에 배치됩니다. 데이터베이스 파일의 백업이 더 이상 허용되지 않게 백업 상태 컴퓨터가 고급 상태가 됩니다. 이 시점 이후 백업을 위해 데이터베이스 패치 파일 및 트랜잭션 로그 파일만 열 수 있습니다.

실패 시 출력 버퍼의 상태가 정의되지 않습니다. 실패하면 instance 대한 전체 백업 프로세스가 취소됩니다.

설명

출력 버퍼가 너무 작아서 백업 파일 집합의 일부여야 하는 파일의 전체 목록을 수락할 수 없는 경우 이 API는 오류 또는 경고를 반환하지 않습니다. 애플리케이션은 항상 이 목록의 실제 크기를 수신하고 해당 정보를 사용하여 목록이 잘렸는지 확인하는 버퍼를 제공해야 합니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista 또는 Windows XP가 필요합니다.
서버	Windows Server 2008 또는 Windows Server 2003이 필요합니다.
머리글	Esent.h에서 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
유니코드	JetGetLogInfoInstanceW(유니코드) 및 JetGetLogInfoInstanceA(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService