c-treeDB API for C++ - Developers Guide

CTSession::GetNextActive

Syntax

CTDatabase* GetNextActive( )

CTDatabase* GetNextActive(VRLEN& ScanRec)

Parameters

ScanRec [in and out] the holder of the scan status; it is returned by GetFirstActive().

Description

Retrieves the next active database. The first prototype may be used when just one scan is being done. If more than one scan must be done, the GetNextActive(VRLEN& ScanRec) must be used, with different ScanRec parameters for each scan. In order to use GetNextActive(), an active record is required. An active record is obtained using one of the retrieval methods, GetFirstActive() or FindActive().

Return

GetNextDatabase() returns the next active database in the session or 0 if there are no active databases in the session.