JET_TABLECREATE 구조체

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_TABLECREATE 구조체

JET_TABLECREATE 구조에는 ESE 데이터베이스의 열 및 인덱스로 채워진 테이블을 만드는 데 필요한 정보가 포함되어 있습니다. JET_TABLECREATE 구조체는 JetCreateTableColumnIndex에서 사용됩니다.

    typedef struct tagJET_TABLECREATE {
      unsigned long cbStruct;
      tchar* szTableName;
      tchar* szTemplateTableName;
      unsigned long ulPages;
      unsigned long ulDensity;
      JET_COLUMNCREATE* rgcolumncreate;
      unsigned long cColumns;
      JET_INDEXCREATE* rgindexcreate;
      unsigned long cIndexes;
      JET_GRBIT grbit;
      JET_TABLEID tableid;
      unsigned long cCreated;
    } JET_TABLECREATE;

멤버

cbStruct

이 구조체의 크기(향후 확장용)(바이트)입니다. sizeof( JET_TABLECREATE )(바이트)로 설정해야 합니다.

szTableName

만들 테이블의 이름입니다.

이름은 다음 조건을 충족하는 를 사용해야 합니다.

종료 NULL을 포함하지 않고 JET_cbNameMost 미만의 값을 갖습니다.

문자 집합으로 구성됩니다. 0~9, A~Z, a~z 및 느낌표(!), 쉼표(,), 여는 대괄호([), 닫는 대괄호(]), 즉, ASCII 문자 0x20, 0x2d 0x22, 0x5a 통해 0x2f, 0x5c 및 0x7f 통해 0x5d.

공백으로 시작하지 않습니다.

공백이 아닌 문자로 구성됩니다.

szTemplateTableName

기본 DDL(데이터 정의 언어)을 상속할 기존 테이블의 이름입니다. 템플릿 테이블을 사용하면 동일한 열과 인덱스를 사용하여 많은 테이블을 쉽게 만들 수 있습니다.

ulPages

테이블에 할당할 데이터베이스 페이지의 초기 수입니다. 이 테이블에 많은 행이 삽입되면 하나보다 큰 숫자를 지정하면 조각화를 줄일 수 있습니다.

ulDensity

테이블 밀도(백분율)입니다. 숫자는 0이거나 20~100 범위여야 합니다. 0을 전달하면 기본값을 사용해야 합니다. 기본값은 80입니다.

rgcolumncreate

각각 새 테이블에서 만들 열에 해당하는 JET_COLUMNCREATE 구조체의 배열입니다.

cColumns

rgcolumncreate의 JET_COLUMNCREATE 요소 수입니다.

rgindexcreate

각각 새 테이블에서 만들 인덱스에 해당하는 JET_INDEXCREATE 구조체의 배열입니다.

cIndexes

rgindexcreate의 JET_INDEXCREATE 요소 수입니다.

grbit

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

값	의미
JET_bitTableCreateFixedDDL	JET_bitTableCreateFixedDDL 설정하면 테이블에서 DDL 작업(예: 열 추가 또는 제거)이 방지됩니다.
JET_bitTableCreateTemplateTable	JET_bitTableCreateTemplateTable 설정하면 테이블이 템플릿 테이블이 됩니다. 그런 다음 새 테이블은 이 테이블의 이름을 템플릿 테이블로 지정할 수 있습니다. JET_bitTableCreateTemplateTable 설정하면 JET_bitTableCreateFixedDDL 의미합니다.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	더 이상 사용되지 않습니다. 사용하지 마십시오.

tableid

API 호출이 성공하는 경우 새 테이블의 JET_TABLEID 포함하는 출력 필드입니다. API 호출이 실패하면 값이 정의되지 않습니다.

cCreated

API 호출이 성공하면 생성된 개체 수를 포함하는 출력 필드입니다. API 호출이 실패하면 값이 정의되지 않습니다.

만들어진 개체의 수는 성공적으로 만들어진 열, 테이블 및 인덱스의 합계와 같습니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에 선언되었습니다.
유니코드	JET_TABLECREATE_W(유니코드) 및 ANSI(JET_TABLECREATE_A)로 구현됩니다.

참고 항목

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

JET_TABLECREATE 구조체