Estrutura JET_TABLECREATE

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Estrutura JET_TABLECREATE

A estrutura JET_TABLECREATE contém as informações necessárias para criar uma tabela preenchida com colunas e índices em um banco de dados ESE. A estrutura JET_TABLECREATE é usada por 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;

Membros

Cbstruct

O tamanho dessa estrutura em bytes (para expansão futura). Ele deve ser definido como sizeof( JET_TABLECREATE ) em bytes.

szTableName

O nome da tabela a ser criada.

O nome deve ser usado para atender às seguintes condições:

Tenha um valor menor que JET_cbNameMost, sem incluir o NULL de terminação.

Consiste no seguinte conjunto de caracteres: 0 a 9, A a Z, a a z e todas as outras pontuações, exceto pelo ponto de exclamação (!), vírgula (,), colchete de abertura ([) e colchete de fechamento (]), ou seja, caracteres ASCII 0x20, 0x22 por meio de 0x2d, 0x2f por meio de 0x5a, 0x5c e 0x5d até 0x7f.

Não comece com um espaço.

Consiste em pelo menos um caractere que não seja de espaço.

szTemplateTableName

O nome de uma tabela já existente da qual herdar DDL base (Linguagem de Definição de Dados). O uso de uma tabela de modelo permite a fácil criação de muitas tabelas com colunas e índices idênticos.

ulPages

O número inicial de páginas de banco de dados a serem alocadas para a tabela. Especificar um número maior que um poderá reduzir a fragmentação se muitas linhas forem inseridas nesta tabela.

ulDensity

A densidade da tabela, em pontos percentuais. O número deve ser 0 ou no intervalo de 20 a 100. Passar 0 significa que o valor padrão deve ser usado. O padrão é 80.

rgcolumncreate

Uma matriz de estruturas JET_COLUMNCREATE , cada uma das quais corresponde a uma coluna a ser criada na nova tabela.

Ccolumns

O número de elementos JET_COLUMNCREATE em rgcolumncreate.

rgindexcreate

Uma matriz de estruturas JET_INDEXCREATE , cada uma das quais corresponde a um índice a ser criado na nova tabela.

cIndexes

O número de elementos JET_INDEXCREATE em rgindexcreate.

grbit

Um grupo de bits que contém as opções para essa chamada, que incluem zero ou mais dos valores a seguir.

Valor	Significado
JET_bitTableCreateFixedDDL	Definir JET_bitTableCreateFixedDDL impede operações DDL na tabela (como adicionar ou remover colunas).
JET_bitTableCreateTemplateTable	Definir JET_bitTableCreateTemplateTable faz com que a tabela seja uma tabela de modelo. Em seguida, novas tabelas podem especificar o nome dessa tabela como sua tabela de modelo. Definir JET_bitTableCreateTemplateTable implica JET_bitTableCreateFixedDDL.
JET_bitTableCreateNoFixedVarColumnsInDerivedTables	Preterido. Não use.

Tableid

Um campo de saída que contém o JET_TABLEID da nova tabela se a chamada à API for bem-sucedida. Se a chamada à API falhar, o valor será indefinido.

cCreated

Um campo de saída que contém a contagem de objetos criados se a chamada à API for bem-sucedida. Se a chamada à API falhar, o valor será indefinido.

A contagem de objetos criados é igual à soma de colunas, tabelas e índices criados com êxito.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.
Unicode	Implementado como JET_TABLECREATE_W (Unicode) e ANSI (JET_TABLECREATE_A ).

Consulte Também

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLEID
JET_INDEXCREATE
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2

Estrutura JET_TABLECREATE