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

Artículo
06/13/2023

Recupera un único valor de columna del registro actual. El registro es ese registro asociado a la entrada de índice en la posición actual del cursor. Como alternativa, esta función puede recuperar una columna de un registro que se crea en el búfer de copia del cursor. Esta función también puede recuperar datos de columna de una entrada de índice que haga referencia al registro actual. Además de recuperar el valor de columna real, JetRetrieveColumn también se puede usar para recuperar el tamaño de una columna, antes de recuperar los datos de columna en sí para que los búferes de la aplicación se puedan ajustar adecuadamente.

Espacio de nombres:Microsoft.Isam.Esent.Interop
Ensamblaje: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Sintaxis

'Declaration
Public Shared Function JetRetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    data As Byte(), _
    dataSize As Integer, _
    dataOffset 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 dataOffset 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, _
    dataOffset, actualDataSize, grbit, _
    retinfo)

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

Parámetros

sesid
Tipo: Microsoft.Isam.Esent.Interop.JET_SESID

Sesión que se va a usar.

tableid
Tipo: Microsoft.Isam.Esent.Interop.JET_TABLEID

Cursor del que se va a recuperar la columna.

columnid
Tipo: Microsoft.Isam.Esent.Interop.JET_COLUMNID

Columnid que se va a recuperar.

datos
Tipo: []

Búfer de datos en el que se va a recuperar.

dataSize
Tipo: System.Int32

Tamaño del búfer de datos.

dataOffset
Tipo: System.Int32

Desplazamiento en el búfer de datos en el que se van a leer los datos.

actualDataSize
Tipo: System.Int32

Devuelve el tamaño real del búfer de datos.

grbit
Tipo: Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

Recupere las opciones de columna.

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

Si pretinfo se proporciona como NULL, la función se comporta como si se proporcionara una itagSequence de 1 y un ibLongValue de 0 (cero). Esto hace que la recuperación de columnas recupere el primer valor de una columna con varios valores y recupere datos largos en el desplazamiento 0 (cero).