If the records with the specified key ranges are not in the buffer cache, then start asynchronous reads to bring the records into the database buffer cache.
Namespace: Microsoft.Isam.Esent.Interop.Windows8
Assembly: Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)
Syntax
'Declaration
Public Shared Function JetTryPrereadIndexRanges ( _
sesid As JET_SESID, _
tableid As JET_TABLEID, _
indexRanges As JET_INDEX_RANGE(), _
rangeIndex As Integer, _
rangeCount As Integer, _
<OutAttribute> ByRef rangesPreread As Integer, _
columnsPreread As JET_COLUMNID(), _
grbit As PrereadIndexRangesGrbit _
) As Boolean
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim indexRanges As JET_INDEX_RANGE()
Dim rangeIndex As Integer
Dim rangeCount As Integer
Dim rangesPreread As Integer
Dim columnsPreread As JET_COLUMNID()
Dim grbit As PrereadIndexRangesGrbit
Dim returnValue As Boolean
returnValue = Windows8Api.JetTryPrereadIndexRanges(sesid, _
tableid, indexRanges, rangeIndex, _
rangeCount, rangesPreread, columnsPreread, _
grbit)
public static bool JetTryPrereadIndexRanges(
JET_SESID sesid,
JET_TABLEID tableid,
JET_INDEX_RANGE[] indexRanges,
int rangeIndex,
int rangeCount,
out int rangesPreread,
JET_COLUMNID[] columnsPreread,
PrereadIndexRangesGrbit grbit
)
Parameters
-
sesid
Type: Microsoft.Isam.Esent.Interop.JET_SESIDThe session to use.
-
tableid
Type: Microsoft.Isam.Esent.Interop.JET_TABLEIDThe table to issue the prereads against.
-
indexRanges
Type: []The key ranges to preread.
-
rangeIndex
Type: System.Int32The index of the first key range in the array to read.
-
rangeCount
Type: System.Int32The maximum number of key ranges to preread.
-
rangesPreread
Type: System.Int32Returns the number of keys actually preread.
-
columnsPreread
Type: []List of column ids for long value columns to preread.
-
grbit
Type: Microsoft.Isam.Esent.Interop.Windows8.PrereadIndexRangesGrbitPreread options. Used to specify the direction of the preread.
Return value
Type: System.Boolean
[true] if some preread done, [false] otherwise.
See also
Reference
Microsoft.Isam.Esent.Interop.Windows8 namespace
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
