Estrutura JET_COLUMNLIST

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Estrutura JET_COLUMNLIST

A estrutura JET_COLUMNLIST contém as informações necessárias para percorrer a tabela temporária criada pelas funções JetGetColumnInfo e JetGetTableColumnInfo . Cada linha na tabela temporária descreve uma coluna na tabela fornecida na chamada à API. Essa estrutura é usada apenas com JetGetColumnInfo e JetGetTableColumnInfo.

    typedef struct {
      unsigned long cbStruct;
      JET_TABLEID tableid;
      unsigned long cRecord;
      JET_COLUMNID columnidPresentationOrder;
      JET_COLUMNID columnidcolumnname;
      JET_COLUMNID columnidcolumnid;
      JET_COLUMNID columnidcoltyp;
      JET_COLUMNID columnidCountry;
      JET_COLUMNID columnidLangid;
      JET_COLUMNID columnidCp;
      JET_COLUMNID columnidCollate;
      JET_COLUMNID columnidcbMax;
      JET_COLUMNID columnidgrbit;
      JET_COLUMNID columnidDefault;
      JET_COLUMNID columnidBaseTableName;
      JET_COLUMNID columnidBaseColumnName;
      JET_COLUMNID columnidDefinitionName;
    } JET_COLUMNLIST;

Membros

Cbstruct

O tamanho da estrutura em bytes. A chamada à API atualizará esse campo, portanto, o chamador deve garantir que esse valor corresponda a sizeof( JET_COLUMNLIST ).

Tableid

O identificador de tabela da tabela temporária que foi criada. É responsabilidade do chamador fechar a tabela.

cRecord

O número de registros na tabela temporária que foi criada pela chamada à API.

columnidPresentationOrder

O identificador de coluna da ordem de apresentação.

A ordem de apresentação é usada para classificar as linhas da tabela temporária. A ordem de apresentação é uma JET_coltypLong fixa. Se o nível de informação especificado não for um nível compacto, ele também será marcado como JET_bitColumnTTKey.

columnidcolumnname

O identificador de coluna do nome da coluna.

Se o nível de informação especificado não for compacto, ele também será marcado como JET_bitColumnTTKey.

columnidcolumnid

O identificador de coluna do identificador de coluna.

O identificador de coluna é um JET_coltypLong fixo.

columnidcoltyp

O identificador de coluna do tipo de coluna.

O tipo de coluna é um JET_coltypLong fixo.

columnidCountry

O identificador de coluna do código do país.

O código do país é um JET_coltypShort fixo.

columnidLangid

O identificador de coluna do identificador de idioma.

O identificador de idioma é um JET_coltypShort fixo.

columnidCp

O identificador de coluna da página de código.

A página de código é um JET_coltypShort fixo.

columnidCollate

O identificador de coluna da sequência de ordenação.

A sequência de ordenação é um JET_coltypShort fixo.

columnidcbMax

O identificador de coluna do campo cbMax .

O cbMax é um JET_coltypLong fixo.

columnidgrbit

O identificador de coluna dos grbits da coluna. O campo grbit é um JET_coltypLong fixo. Para obter mais informações sobre esses bits, consulte JET_COLUMNDEF.

Veja a seguir os valores possíveis para columnidgrbit:

JET_bitColumnTagged

JET_bitColumnFixed

JET_bitColumnUpdatable

JET_bitColumnNotNULL

JET_bitColumnAutoincrement

JET_bitColumnVersion

JET_bitColumnMultiValued

JET_bitColumnEscrowUpdate

JET_bitColumnFinalize

JET_bitColumnDeleteOnZero

JET_bitColumnUserDefinedDefault

columnidDefault

O identificador de coluna do valor padrão da coluna.

O valor padrão é um JET_coltypLongBinary.

columnidBaseTableName

O identificador de coluna do nome da tabela da qual a tabela foi derivada.

O nome da tabela é um JET_coltypText.

columnidBaseColumnName

O identificador de coluna do nome da coluna da qual a coluna foi derivada.

O nome da coluna é um JET_coltypText.

columnidDefinitionName

O identificador de coluna do nome da definição de coluna.

O nome da definição de coluna é um JET_coltypText.

Comentários

Por padrão, a ordem das linhas na tabela temporária é classificada pelo nome da coluna. Ele também pode ser classificado por identificador de coluna. Para obter mais informações sobre como classificar por identificador de coluna, consulte JetGetColumnInfo e JetGetTableColumnInfo.

A chamada para JetGetColumnInfo ou JetGetTableColumnInfo pode especificar uma forma compacta de resultados. Se alguma coluna tiver sido herdada de uma tabela de modelo, os resultados compactos não as armazenarão.

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.