Método Api.RetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, RetrieveColumnGrbit, JET_RETINFO)

Recupera um único valor de coluna do registro atual. O registro é aquele registro 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 RetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As Byte()
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As Byte()

returnValue = Api.RetrieveColumn(sesid, _
    tableid, columnid, grbit, retinfo)
public static byte[] RetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

Parâmetros

  • 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 com vários valores e recupere dados longos no deslocamento 0 (zero).

Valor retornado

Tipo: []
Os dados recuperados da coluna. Nulo se a coluna for nula.

Confira também

Referência

Classe de API

Membros da API

Sobrecarga do RetrieveColumn

Namespace Microsoft.Isam.Esent.Interop