DB_Reactivate

This function is used upon returning from a E_ACTIV event to reopen the application's database(s). If the database file has been closed with DB_Deactivate, no calls should be issued to the engine with that database until it has been DB_Reactivated. This call reopens the DOS file handle and removes the write protection from the file.

• Syntax:             int DB_Reactivate(DBBLOCK *dblk); 

• Returns: DB_OK File was reactivated or file was already reactivated.

  DB_OPEN File cannot be reopened (does not exist, bad name, no DOS handles, etc.).

  DB_SIGNATURE File is no longer a database file.

  DB_FILETYPE Type of file is different than expected.

  DB_RELEASE Database engine release is now different. See "DB_Open" on page 11-423 for more details.

  DB_SORTCHANGE The system sort order has changed, invalidating all viewpoints in memory. The database must be reopened to correct this condition.

Note: If the reactivate fails, the database has been shut down. Either the same database can be attempted to be reopened, or the user must specify another file.

• May Move Memory:    Yes