mi_integer am_rescan(MI_AM_SCAN_DESC *scanDesc)

scanDesc

points to the scan descriptor.

Although am_rescan is an optional purpose function, the access method can enhance efficiency by supplying am_rescan for applications that involve joins, subqueries, and other multiple-pass scan processes. The am_rescan purpose function ends the previous scan in an appropriate manner and begins a new scan on the same open index.

Without an am_rescan purpose function, the database server calls the am_endscan function and then am_beginscan, if the access method provides these functions.

MI_OK indicates success. MI_ERROR indicates failure.

See the descriptions of:

• Purpose function am_getnext
• Accessor functions mi_qual_const_depends_outer() and mi_scan_newquals() in Descriptor Function Reference
• Optimizing Queries