JET_TABLECREATE3 结构

适用于： Windows |Windows Server

JET_TABLECREATE3 结构包含创建在可扩展存储引擎 (ESE) 数据库中填充列和索引的表所需的信息，并指定回调函数。 JET_TABLECREATE3 结构由 JetCreateTableColumnIndex3 函数使用。

JET_TABLECREATE3结构是在 Windows 7 操作系统中引入的。

typedef struct tagJET_TABLECREATE3 {
  unsigned long cbStruct;
  tchar* szTableName;
  tchar* szTemplateTableName;
  unsigned long ulPages;
  unsigned long ulDensity;
  JET_COLUMNCREATE* rgcolumncreate;
  unsigned long cColumns;
    JET_INDEXCREATE2* rgindexcreate;
  unsigned long cIndexes;
  tchar* szCallback;
  JET_CBTYP cbtyp;
  JET_GRBIT grbit;
  JET_TABLEID tableid;
  un  JET_GRBIT grbit;
  JET_SPACEHINTS* pSeqSpacehints;
  JET_SPACEHINTS* pLVSpacehints;
  unsigned long cbSeparateLV;
  JET_TABLEID tableid;
  unsigned long cCreated;
} JET_TABLECREATE3;>

成员

cbStruct

此结构的大小（以字节为单位） (以供将来扩展) 。 必须将其设置为 sizeof ( JET_TABLECREATE3 ) （以字节为单位）。

szTableName

要创建的表的名称。

该名称必须满足以下条件：

• 它的值必须小于 JET_cbNameMost，不包括终止 null。

• 它必须包含以下一组字符：0 到 9、A 到 Z、a 到 z，以及除感叹号 (！) 、逗号 (、) 、左方括号 ([) 和右方括号 (]) 以外的所有其他标点;即 ASCII 字符0x20、0x22到0x2d、0x2f到0x5a、0x5c，以及通过0x7f 0x5d。

• 它不得以空格开头。

• 它必须至少包含一个非空格字符。

szTemplateTableName

从中继承基本数据定义语言的现有表的名称 (DDL) 。 使用模板表可以轻松创建具有相同列和索引的许多表。

ulPages

要为表分配的初始数据库页数。 如果在此表中插入了许多行，则指定大于 1 的数字可以减少碎片。

ulDensity

表密度（以百分点为单位）。 数字必须为 0 或介于 20 到 100 的范围内。 传递 0 表示应使用默认值。 默认值为 80。

rgcolumncreate

JET_COLUMNCREATE 结构的数组，其中每个结构对应于要在新表中创建的列。

cColumns

rgcolumncreate 参数中的JET_COLUMNCREATE元素数。

rgindexcreate

一个JET_INDEXCREATE2结构的数组，其中每个结构都对应于要在新表中创建的索引。

cIndexes

rgindexcreate 参数中JET_INDEXCREATE2个元素的数目。

szCallback

在特定事件期间调用的函数。 cbtyp 确定何时调用回调函数。

szCallback 的格式必须是“module！function”，例如，“alpha！beta”是指名为“alpha”的模块中的 beta 函数。

函数的原型必须与 JET_CALLBACK 回调函数匹配。

cbtyp

描述 szCallback 指定的回调函数的类型。 有关详细信息，请参阅 JET_CBTYP。

此位域由下表中列出的一个或多个位值组成。

grbit

一组位，其中包含下表中列出的零个或多个调用选项值。

pSeqSpacehints

指向默认顺序索引 JET_SPACEHINTS 结构的指针。

pSeqSpacehints 是在 Windows 7 中引入的。

pLVSpacehints

指向分隔长值树 JET_SPACEHINTS 结构的指针。

pLVSpacehints 是在 Windows 7 中引入的。

cbSeparateLV

用于将内部 LV 与主记录分开的大小。 分隔的 LV 树的任何长值 c 结构。 有关详细信息，请参阅 JET_SPACEHINTS 中的 ng 值。 如果记录变得太大，则小于此值的长值列可能会分隔。

cbSeparateLV 是在 Windows 7 中引入的。

tableid

如果 API 调用成功，则保留新表 JET_TABLEID 的输出字段。 如果 API 调用失败，则该值未定义。 此表以独占方式打开。

cCreated

一个输出字段，其中包含在 API 调用成功时创建的 对象的计数。 如果 API 调用失败，则该值未定义。

创建的对象计数等于成功创建的列、表和索引的总和。

要求

另请参阅

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_TABLEID
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2
JetDefragment2