DB_Select

Sets the state of a TYPE_DATA record to be selected (status=1), unselected (status=0), or toggled (status=2). This is used to track multiple selections made by the user. Once made, selections must be cleared by the application. Note that the select state is not retained by the database after closing the file, nor is it retained if the record is modified. Undo does not affect selection status.

• Syntax:             int DB_Select(DBBLOCK *dblk, RECORDNUM recordnum, 
                      int status); 

• Returns: DB_OK Select was successful.

  DB_NOTFOUND Recordnum is not in the database.

  DB_DELETED Record is deleted.

• May Move Memory: No