Método Api.JetRetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, RetrieveColumnGrbit JET_RETINFO)

  • Artigo

Recupera um único valor de coluna do registro atual. O registro é aquele associado à entrada de índice na posição atual do cursor. Como alternativa, essa função pode recuperar uma coluna de um registro que está sendo criado no buffer de cópia do cursor. Essa função também pode recuperar dados de coluna de uma entrada de índice que faz referência ao registro atual. Além de recuperar o valor real da coluna, JetRetrieveColumn também pode ser usado para recuperar o tamanho de uma coluna, antes de recuperar os próprios dados de coluna para que os buffers de aplicativo possam ser dimensionados adequadamente.

Namespace:Microsoft.Isam.Esent.Interop
Assembly: Microsoft.Isam.Esent.Interop (em Microsoft.Isam.Esent.Interop.dll)

Sintaxe

'Declaration
Public Shared Function JetRetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    data As Byte(), _
    dataSize As Integer, _
    <OutAttribute> ByRef actualDataSize As Integer, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim data As Byte()
Dim dataSize As Integer
Dim actualDataSize As Integer
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As JET_wrn

returnValue = Api.JetRetrieveColumn(sesid, _
    tableid, columnid, data, dataSize, _
    actualDataSize, grbit, retinfo)

public static JET_wrn JetRetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    byte[] data,
    int dataSize,
    out int actualDataSize,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

Parâmetros

  • data
    Tipo: []

    O buffer de dados no qual será recuperado.

  • actualDataSize
    Tipo: System.Int32

    Retorna o tamanho real do buffer de dados.

  • retinfo
    Tipo: Microsoft.Isam.Esent.Interop.JET_RETINFO

    Se pretinfo for dado como NULL, a função se comportará como se fosse uma itagSequence de 1 e um ibLongValue de 0 (zero). Isso faz com que a recuperação de coluna recupere o primeiro valor de uma coluna de vários valores e recupere dados longos no deslocamento 0 (zero).

Valor retornado

Tipo: Microsoft.Isam.Esent.Interop.JET_wrn
Um código de aviso ESENT.

Comentários

As funções RetrieveColumnAs fornecem funções de recuperação específicas do tipo de dados.

Confira também

Referência

Classe API

Membros da API

Sobrecarga de JetRetrieveColumn

Namespace Microsoft.Isam.Esent.Interop