JetDetachDatabase2 함수

적용 대상: Windows | Windows Server

JetDetachDatabase2 함수

JetDetachDatabase2 함수는 이전에 데이터베이스 세션에 연결된 데이터베이스 파일을 해제합니다.

Windows XP:JetDetachDatabase2 는 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetDetachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

매개 변수

sesid

API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.

szFilename

분리할 데이터베이스의 이름입니다. szFilename이 NULL이거나 빈 문자열인 경우 sesid에 연결된 모든 데이터베이스가 분리됩니다.

grbit

다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.

값

의미

JET_bitForceCloseAndDetach

데이터베이스를 강제로 닫고 분리합니다. JET_bitForceCloseAndDetach 지원되지 않으면 JET_errForceDetachNotAllowed 반환됩니다.

JET_bitForceDetach

데이터베이스를 강제로 분리합니다. JET_bitForceDetach 지원되지 않으면 JET_errForceDetachNotAllowed 반환됩니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errBackupInProgress

데이터베이스가 백업되고 있으며 분리할 수 없습니다.

JET_errDatabaseInUse

데이터베이스가 JetOpenDatabase에서 열렸습니다. 분리하기 전에 데이터베이스를 닫아야 합니다.

JET_errDatabaseNotFound

데이터베이스가 이전에 연결되지 않았습니다( JetAttachDatabase 또는 JetAttachDatabase2 참조).

JET_errForceDetachNotAllowed

JET_bitForceDetach 지원되지 않습니다.

JET_errInTransaction

트랜잭션에 있는 동안 데이터베이스를 분리하려고 했습니다.

설명

연결된 데이터베이스가 열린 경우( JetAttachDatabase 사용) 분리하기 전에 JetCloseDatabase 를 사용하여 닫아야 합니다.

Windows 2000만 해당: JetTerm 을 호출하기 전에 분리되지 않은 데이터베이스는 JetInit 가 다음에 호출될 때 자동으로 다시 연결됩니다.

요구 사항

요구 사항 값

클라이언트

Windows Vista 또는 Windows XP가 필요합니다.

서버

Windows Server 2008 또는 Windows Server 2003이 필요합니다.

머리글

Esent.h에서 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

유니코드

JetDetachDatabase2W(유니코드) 및 JetDetachDatabase2A(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCloseDatabase
JetCreateDatabase
JetCreateDatabase2
JetInit
JetOpenDatabase
JetTerm