Estrutura JET_TABLECREATE2

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Estrutura JET_TABLECREATE2

A estrutura JET_TABLECREATE2 contém as informações necessárias para criar uma tabela preenchida com colunas e índices em um banco de dados ESE e que designa uma função de retorno de chamada. A estrutura JET_TABLECREATE2 é usada por JetCreateTableColumnIndex2.

Windows XP: A estrutura JET_TABLECREATE2 é introduzida no Windows XP.

    typedef struct tagJET_TABLECREATE2 {
      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;
      tchar* szCallback;
      JET_CBTYP cbtyp;
      JET_GRBIT grbit;
      JET_TABLEID tableid;
      unsigned long cCreated;
    } JET_TABLECREATE2;

Membros

Cbstruct

O tamanho dessa estrutura em bytes (para expansão futura). Ele deve ser definido como sizeof( JET_TABLECREATE2 ) 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 para ponto de exclamação (!), vírgula (,), colchete de abertura ([) e colchete de fechamento (]), ou seja, caracteres ASCII 0x20, 0x22 por 0x2d, 0x2f 0x5a, 0x5c e 0x5d por meio de 0x7f.

Não comece com um espaço.

Consiste em pelo menos um caractere sem 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 criação fácil 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 de 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 de JET_INDEXCREATE , cada uma corresponde a um índice a ser criado na nova tabela.

cIndexes

O número de elementos JET_INDEXCREATE em rgindexcreate.

szCallback

A função que é chamada durante determinados eventos. cbtyp determina quando a função de retorno de chamada será chamada.

O formato de szCallback deve ser "module!function"— por exemplo, "alpha!beta" refere-se à função beta no módulo chamado "alpha". O protótipo da função deve corresponder JET_CALLBACK. Para obter mais informações, consulte JET_CALLBACK.

cbtyp

Descreve o tipo de função de retorno de chamada designada por szCallback. Para obter mais informações, consulte JET_CBTYP. Esse campo de bits é composto por um ou mais dos bits a seguir.

Valor	Significado
JET_cbtypFinalize	A função de retorno de chamada será chamada quando uma coluna que pode ser finalizada tiver ido para zero.
JET_cbtypBeforeInsert	A função de retorno de chamada será chamada antes da inserção de registro.
JET_cbtypAfterInsert	A função de retorno de chamada será chamada depois que o mecanismo de banco de dados terminar de inserir um registro.
JET_cbtypBeforeReplace	A função de retorno de chamada será chamada antes da modificação de um registro.
JET_cbtypAfterReplace	A função de retorno de chamada será chamada após a modificação final de um registro.
JET_cbtypBeforeDelete	A função de retorno de chamada será chamada antes da exclusão de um registro.
JET_cbtypAfterDelete	A função de retorno de chamada será chamada depois que um registro for excluído.
JET_cbtypUserDefinedDefaultValue	A função de retorno de chamada será chamada para calcular um padrão definido pelo usuário.
JET_cbtypOnlineDefragCompleted	A função de retorno de chamada será chamada após a conclusão de uma chamada para JetDefragment2 .
JET_cbtypFreeCursorLS	A função de retorno de chamada será chamada quando o armazenamento local associado a um cursor precisar ser liberado.
JET_cbtypFreeTableLS	A função de retorno de chamada será chamada quando o armazenamento local associado a uma tabela precisar ser liberado.

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	Deve ser usado em conjunto com JET_bitTableCreateTemplateTable. 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 o Windows Vista ou o Windows XP.
Servidor	Requer o Windows Server 2008 ou o Windows Server 2003.
Cabeçalho	Declarado em Esent.h.
Unicode	Implementado como JET_TABLECREATE2_W (Unicode) e ansi (JET_TABLECREATE2_A ).

Consulte Também

JET_CALLBACK
JET_CBTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_INDEXCREATE
JET_TABLEID
JetCreateTable
JetCreateTableColumnIndex
JetCreateTableColumnIndex2
JetDefragment2

Estrutura JET_TABLECREATE2