Compartilhar via


Estrutura JET_RETINFO

Aplica-se a: Windows | Windows Server

Estrutura JET_RETINFO

A estrutura JET_RETINFO contém parâmetros opcionais de entrada e saída para JetRetrieveColumn. Um ponteiro nulo pode ser passado em que um ponteiro para essa estrutura seria passado de outra forma. Passar um ponteiro nulo é o mesmo que passar JET_RETINFO com cbStruct definido como sizeof(JET_RETINFO), ibLongValue definido como 0 (zero) e itagSequence definido como 1.

    typedef struct {
      unsigned long cbStruct;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
    } JET_RETINFO;

Membros

Cbstruct

Deve ser definido como o tamanho da estrutura JET_RETINFO , em bytes, e serve para confirmar a presença dos campos a seguir.

ibLongValue

O deslocamento para o primeiro byte a ser recuperado de uma coluna do tipo JET_coltypLongBinary ou JET_coltypLongText. Observe que a quantidade de dados recuperados desse deslocamento é a menor do tamanho do buffer de saída e o tamanho dos dados no valor real após esse deslocamento.

itagSequence

Descreve o número de sequência de valor em uma coluna com vários valores. Observe que a matriz de valores é baseada em um. O primeiro valor é a sequência 1, não 0. Se a coluna de registro tiver apenas um valor, 1 deverá ser passada como itagSequence

Com uma coluna que pode conter vários valores, só é possível usar um número de sequência maior que 1 em JetSetColumn e JetRetrieveColumn ou 0 em JetSetColumn. Na implementação atual do mecanismo, qualquer coluna criada com JET_bitColumnTagged pode conter vários valores. As colunas criadas com JET_bitColumnMultiValued diferem das colunas marcadas com valores múltiplos apenas da maneira como são indexadas. Consulte JET_INDEXCREATE para obter mais informações.

columnidNextTagged

Retorna a columnid da coluna marcada, com valores múltiplos ou esparsos recuperados quando todas as colunas marcadas são recuperadas passando 0 como columnid para JetRetrieveColumn.

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.

Consulte Também

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn