JetResizeDatabase 함수

적용 대상: Windows | Windows Server

JetResizeDatabase 함수는 현재 열려 있는 데이터베이스의 크기를 확장하거나 축소합니다.

JetResizeDatabase 함수는 Windows 8 운영 체제에 도입되었습니다.

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

매개 변수

sesid

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

dbid

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

포장 소비재

요청된 데이터베이스 크기(페이지)입니다.

pcpgActual

API 호출 후 데이터베이스의 크기를 페이지 단위로 받는 숫자에 대한 포인터입니다. API 호출이 실패하면 pcpgActual 매개 변수의 내용이 정의되지 않습니다.

grbit

다음 표에 나열된 값 중 0개 이상을 지정하는 비트 그룹입니다.

값	의미
JET_bitResizeDatabaseOnlyGrow	데이터베이스만 확장합니다. 크기 조정 호출이 데이터베이스를 축소하는 경우 아무 작업도 수행하지 않습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errDiskFull	볼륨에 증가 작업을 수행할 수 있는 여유 공간이 부족합니다.
JET_errDiskIO	JetSetDatabaseSize 함수에서 파일 관련 오류가 반환되었습니다. 반환될 수 있는 다른 파일 관련 오류에 대한 자세한 내용은 JetSetDatabaseSize를 참조하세요.

설명

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

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

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

요구 사항

요구 사항	값
클라이언트	Windows 8 필요합니다.
서버	Windows Server 2012 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.

추가 정보

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize