Api.JetRetrieveColumn 方法 (JET_SESID、JET_TABLEID、JET_COLUMNID、Byte、Int32、Int32、RetrieveColumnGrbit、JET_RETINFO)

项目
06/13/2023

从当前记录中检索单个列值。记录是与光标当前位置的索引项关联的记录。或者，此函数可以从在游标复制缓冲区中创建的记录中检索列。此函数还可以从引用当前记录的索引项中检索列数据。除了检索实际的列值外，JetRetrieveColumn 还可用于检索列的大小，然后再检索列数据本身，以便可以适当调整应用程序缓冲区的大小。

Namespace：Microsoft.Isam.Esent.Interop
装配： Microsoft.Isam.Esent.Interop.dll) 中的 Microsoft.Isam.Esent.Interop (

语法

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

参数

sesid
类型： Microsoft.Isam.Esent.Interop.JET_SESID

要使用的会话。

tableid
类型： Microsoft.Isam.Esent.Interop.JET_TABLEID

要从中检索列的游标。

columnid
类型： Microsoft.Isam.Esent.Interop.JET_COLUMNID

要检索的 columnid。

数据
类型：[]

要检索到的数据缓冲区。

dataSize
类型： System.Int32

数据缓冲区的大小。

actualDataSize
类型： System.Int32

返回数据缓冲区的实际大小。

grbit
类型： Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

检索列选项。

retinfo
类型： Microsoft.Isam.Esent.Interop.JET_RETINFO

如果 pretinfo 被赋予为 NULL，则函数的行为就像给定了 itagSequence 1 和 ibLongValue 0 (零) 一样。这会导致列检索检索多值列的第一个值，并检索偏移量为 0 (零) 的长数据。