Metodo Api.JetRetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

Articolo
06/13/2023

Recupera un singolo valore di colonna dal record corrente. Il record è il record associato alla voce di indice nella posizione corrente del cursore. In alternativa, questa funzione può recuperare una colonna da un record creato nel buffer di copia del cursore. Questa funzione può anche recuperare i dati delle colonne da una voce di indice che fa riferimento al record corrente. Oltre a recuperare il valore effettivo della colonna, JetRetrieveColumn può essere usato anche per recuperare le dimensioni di una colonna, prima di recuperare i dati della colonna stessa in modo che i buffer dell'applicazione possano essere ridimensionati in modo appropriato.

Spazio dei nomi:Microsoft.Isam.Esent.Interop
Assemblea: Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

Sintassi

'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
)

Parametri

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

Sessione da utilizzare.

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

Cursore da cui recuperare la colonna.

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

Columnid da recuperare.

data
Tipo: []

Buffer di dati in cui recuperare.

dataSize
Tipo: System.Int32

Dimensioni del buffer di dati.

actualDataSize
Tipo: System.Int32

Restituisce le dimensioni effettive del buffer di dati.

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

Recuperare le opzioni di colonna.

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

Se pretinfo viene assegnato come NULL, la funzione si comporta come se fosse stato assegnato un itagSequence pari a 1 e un valore ibLongValue pari a 0 (zero). In questo modo, il recupero delle colonne recupera il primo valore di una colonna multivalore e recupera i dati lunghi in corrispondenza dell'offset 0 (zero).