JetGetAttachInfo 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGetAttachInfo 함수

JetGetAttachInfo 함수는 JetBeginExternalBackup에서 시작된 백업 중에 사용하여 백업 파일 집합의 일부가 될 데이터베이스 파일의 이름에 대한 instance 쿼리합니다. JetAttachDatabase를 사용하여 현재 instance 연결된 데이터베이스만 고려됩니다. 이러한 파일은 나중에 JetOpenFile 을 사용하여 열고 JetReadFile을 사용하여 읽을 수 있습니다.

    JET_ERR JET_API JetGetAttachInfo(
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

매개 변수

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	백업 작업이 시퀀스에서 호출되었기 때문에 실패했습니다. 현재 백업이 전체 백업이 아닌 경우 JetGetAttachInfo에서 이 오류를 반환합니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 지정된 instance 핸들이 잘못된 경우 JetGetAttachInfo에 대해 발생할 수 있습니다(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 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
유니코드	JetGetAttachInfoW(유니코드) 및 JetGetAttachInfoA(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService

다음을 통해 공유

JetGetAttachInfo 함수