JetAttachDatabase2 함수

  • 아티클

적용 대상: Windows | Windows Server

JetAttachDatabase2 함수

JetAttachDatabase2 함수는 데이터베이스 instance 사용할 데이터베이스 파일을 연결하고 해당 데이터베이스의 최대 크기를 지정합니다. 데이터베이스를 사용하려면 나중에 JetOpenDatabase를 사용하여 열어야 합니다.

    JET_ERR JET_API JetAttachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          const unsigned long cpgDatabaseSizeMax,
      __in          JET_GRBIT grbit
    );

매개 변수

sesid

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

szFilename

연결할 데이터베이스의 이름입니다.

cpgDatabaseSizeMax

데이터베이스의 최대 크기(데이터베이스 페이지)입니다. 기본 데이터베이스 페이지 크기는 4KB이며 데이터베이스를 만들기 전에 JetSetSystemParameter 함수를 사용하여 변경할 수 있습니다.

0을 전달하면 데이터베이스 엔진에서 적용되는 최대값이 없음을 의미합니다.

grbit

다음 중 0개 이상을 포함하는 이 호출에 사용할 옵션이 포함된 비트 그룹입니다.

값

의미

JET_bitDbDeleteCorruptIndexes

JET_paramEnableIndexChecking 설정된 경우 유니코드 데이터에 대한 모든 인덱스가 삭제됩니다. 자세한 내용은 설명 섹션을 참조하세요.

JET_bitDbDeleteUnicodeIndexes

유니코드 데이터에 대한 모든 인덱스는 JET_paramEnableIndexChecking 설정에 관계없이 삭제됩니다. 자세한 내용은 설명 섹션을 참조하세요.

JET_bitDbReadOnly

데이터베이스 수정을 방지합니다.

JET_bitDbUpgrade

다음에 사용하도록 예약됩니다.

반환 값

함수는 JET_ERR 오류 코드 중 하나를 반환합니다. 가장 일반적으로 반환되는 항목은 다음과 같습니다. (이 API에 대한 전체 오류 목록은 확장 가능한 스토리지 엔진 오류 코드를 참조하세요.)

반환 코드

설명

JET_errSuccess

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

JET_errBackupInProgress

백업 중에는 데이터베이스를 연결할 수 없습니다.

JET_errDatabaseFileReadOnly

szFilename으로 지정된 데이터베이스 파일을 쓸 수 있어야 합니다. Read-Only 특성을 설정해서는 안 되며 실행 중인 프로세스에는 파일에 쓸 수 있는 충분한 권한이 있어야 합니다.

JET_errDatabaseInUse

데이터베이스 파일이 이미 다른 프로세스에 의해 열려 있습니다.

JET_errDatabaseInvalidPath

szFilename에 잘못된 경로가 지정되었습니다. szFilename 은 NULL이 아니어야 하며 유효한 경로를 참조해야 합니다.

JET_errDatabaseSharingViolation

데이터베이스 파일이 이미 다른 세션에 의해 연결되었습니다.

JET_errFileNotFound

szFilename에 지정된 파일이 없습니다.

JET_errPrimaryIndexCorrupted

기본 인덱스 오류가 있습니다. 이는 물리적 손상(예: 디스크 또는 메모리 손상)에서 발생할 수 있습니다. 또한 이전 운영 체제에서 마지막으로 수정된 데이터베이스를 연결할 때 반환될 수 있으며 기본 인덱스는 유니코드 데이터가 있는 열 위에 있습니다. 유니코드 데이터에 대한 인덱스에 대한 자세한 내용은 설명을 참조하세요.

JET_errSecondaryIndexCorrupted

보조 인덱스가 있는 오류가 있습니다. 이는 물리적 손상(예: 디스크 또는 메모리 손상)에서 발생할 수 있습니다. 이전 운영 체제에서 마지막으로 수정된 데이터베이스를 연결하고 보조 인덱스가 유니코드 데이터가 있는 열 위에 있는 경우에도 반환될 수 있습니다. 유니코드 데이터에 대한 인덱스에 대한 자세한 내용은 설명을 참조하세요. 보조 인덱스는 다음 명령을 사용하여 오프라인 유틸리티로 데이터베이스를 조각 모음할 때 완전히 다시 작성됩니다. esentutl -d.

JET_errTooManyAttachedDatabases

instance당 한정된 수의 데이터베이스만 연결할 수 있습니다. 이 제한은 현재 instance당 7개의 데이터베이스입니다.

JET_wrnDatabaseAttached

데이터베이스 파일이 이 세션에서 이미 연결되어 있음을 나타내는 심각하지 않은 경고입니다.

설명

데이터베이스 파일은 JetDetachDatabase 또는 JetDetachDatabase2를 사용하여 분리됩니다.

설명 은 JetAttachDatabase 를 참조하세요.

요구 사항

요구 사항 값

클라이언트

Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.

서버

Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.

머리글

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

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

유니코드

JetAttachDatabase2W(유니코드) 및 JetAttachDatabase2A(ANSI)로 구현됩니다.

참고 항목

확장 가능한 스토리지 엔진 파일
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetCreateDatabase
JetOpenDatabase
JetSetSystemParameter