Estrutura JET_RETINFO

Aplica-se a: Windows | Servidor Windows

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 passado 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 vários valores apenas na forma como são indexadas. Consulte JET_INDEXCREATE para obter mais informações.

columnidNextTagged

Retorna a coluna columnid da coluna marcada, com vários valores ou esparsa recuperada quando todas as colunas marcadas são recuperadas passando 0 como a columnid para JetRetrieveColumn.

Requisitos

Requisito Valor

Cliente

Requer Windows Vista, Windows XP ou Windows 2000 Professional.

Servidor

Requer Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.

Cabeçalho

Declarado em Esent.h.

Consulte Também

JET_COLTYP
JET_COLUMNID
JET_RETINFO
JetRetrieveColumn