DB_CollectGarbage

This function removes unused records in the database. Collecting garbage resets the Undo point (see the following section describing DB_Undo). This happens automatically when the database file is closed. Garbage collection may need to be called at strategic points to prevent disk files from growing too large. After garbage collection, any deleted record numbers will be reclaimed. The DOS file buffer is flushed after garbage collection.

• Syntax:             int DB_CollectGarbage(DBBLOCK *dblk); 

• Returns: DB_OK Garbage collection was successful.

  DB_CORRUPT A media error during garbage collection may have rendered the file unusable.

• May Move Memory: No