JetGrowDatabase 함수

적용 적용: Windows | Windows 서버

JetGrowDatabase 함수

JetGrowDatabase 함수는 현재 열려 있는 데이터베이스의 크기를 확장합니다.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

매개 변수

sesid

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

Dbid

확장할 데이터베이스입니다.

포장 소비재

원하는 데이터베이스 크기(페이지)입니다.

pcpgReal

API 호출 후 데이터베이스의 크기(페이지)를 받는 숫자에 대한 포인터입니다. API 호출이 실패하면 pcpgReal의 콘텐츠가 정의되지 않습니다.

반환 값

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

반환 코드

설명

JET_errSuccess

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

JET_errDiskFull

볼륨에 여유 공간이 부족하여 증가 작업을 수행할 수 없습니다.

JET_errDiskIO

JetSetDatabaseSize에서 파일 관련 오류가 반환되었습니다. 반환될 수 있는 다른 파일 관련 오류에 대한 자세한 내용은 JetSetDatabaseSize를 참조하세요.

설명

대량의 데이터를 삽입하기 전에 JetGrowDatabase를 호출하면 데이터베이스 파일이 한 번의 작업으로 증가합니다. 이렇게 하면 데이터베이스 파일이 파일 시스템 수준에서 조각화될 가능성이 줄어들고 데이터베이스 파일이 증가해야 하는 횟수도 줄어듭니다. 데이터베이스 파일을 한 번 증가시키는 것이 여러 번 증가하는 것보다 빠를 수 있습니다.

파일 증가만 현재 지원됩니다. 파일을 축소하려면 esentutl.exe 유틸리티 프로그램의 조각 모음 기능을 사용합니다.

열려 있지 않은 데이터베이스의 크기를 설정하려면 JetSetDatabaseSize를 참조하세요.

파일 크기가 pcpgReal 에 반환되는 페이지 수와 일치하지 않을 수 있습니다. pcpgReal 에서 계산되지 않을 수 있는 두 개의 추가 예약 페이지가 있습니다.

요구 사항

요구 사항 Value

클라이언트

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

Server

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

머리글

Esent.h에서 선언됩니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize