Api.JetEnumerateColumns 方法

發行項
06/13/2023

有效率地從資料指標的目前記錄或該資料指標的複製緩衝區擷取一組資料行及其值。擷取的資料行和值可以受到資料行識別碼、itagSequence 數位和其他特性的清單所限制。這個資料行擷取 API 是唯一的，它會傳回動態配置記憶體中的資訊，而該記憶體是使用使用者提供的重新配置相容回呼取得。這個新的彈性可讓具有特定特性的資料行資料 (有效率地擷取，例如呼叫端未知的大小和乘數) 。這樣就不需要使用 JetRetrieveColumn 的探索模式來判斷這些特性，才能設定 JetRetrieveColumn 的最終呼叫，以成功擷取所需的資料。

此 API 不符合 CLS 規範。

Namespace：Microsoft.Isam.Esent.Interop
裝配： Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

語法

'Declaration
<CLSCompliantAttribute(False)> _
Public Shared Function JetEnumerateColumns ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    numColumnids As Integer, _
    columnids As JET_ENUMCOLUMNID(), _
    <OutAttribute> ByRef numColumnValues As Integer, _
    <OutAttribute> ByRef columnValues As JET_ENUMCOLUMN(), _
    allocator As JET_PFNREALLOC, _
    allocatorContext As IntPtr, _
    maxDataSize As Integer, _
    grbit As EnumerateColumnsGrbit _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim numColumnids As Integer
Dim columnids As JET_ENUMCOLUMNID()
Dim numColumnValues As Integer
Dim columnValues As JET_ENUMCOLUMN()
Dim allocator As JET_PFNREALLOC
Dim allocatorContext As IntPtr
Dim maxDataSize As Integer
Dim grbit As EnumerateColumnsGrbit
Dim returnValue As JET_wrn

returnValue = Api.JetEnumerateColumns(sesid, _
    tableid, numColumnids, columnids, _
    numColumnValues, columnValues, allocator, _
    allocatorContext, maxDataSize, grbit)

[CLSCompliantAttribute(false)]
public static JET_wrn JetEnumerateColumns(
    JET_SESID sesid,
    JET_TABLEID tableid,
    int numColumnids,
    JET_ENUMCOLUMNID[] columnids,
    out int numColumnValues,
    out JET_ENUMCOLUMN[] columnValues,
    JET_PFNREALLOC allocator,
    IntPtr allocatorContext,
    int maxDataSize,
    EnumerateColumnsGrbit grbit
)