DB_Deactivate

This function is used before leaving an application on a E_DEACTIV event to make sure the database file handle is closed. Failing to do this may cause DOS to run out of file handles. Only the DOS file handle is closed; this does not do garbage collection or any other actions associated with DB_Close. Note that if multiple database files are open, each should be DB_Deactivated.

Deactivation of a file causes the file to be marked read only. This prevents the user from accidentally removing or modifying the file while it is still open by another application.

• Syntax:             int DB_Deactivate(DBBLOCK *dblk); 

• Returns: DB_OK File was deactivated OR file was already deactivated.

  DB_OPEN File was not able to be write protected.

• May Move Memory: No

<}Pre>