This function finds a record by sequential search. Begin and end delimit the range of records, and searchstring is the string to be searched for. If begin is greater than end, the search is performed backwards. The search uses the raw record bytes of the specified type; for data records, even non-field locations are searched. Flags is a combination of the bits DB_FIND_CASE and DB_FIND_FIRST. If DB_FIND_CASE is used, the search is case-sensitive; the default is non-case-sensitive.
Important: If DB_FIND_FIRST is used, the search begins at the 0th byte of record at begin; otherwise, the byte after pos is used. This allows sequential searches to pick up where they left off if the DB_FIND_FIRST flag is omitted. If the int at pos is garbage and the DB_FIND_FIRST flag is not set, the find operation will be unreliable. The position found in the record is returned in pos. Note that this function does not search ROM data records. This function is not typically used for data records. For more information, see DB_FindDataRecord.
Syntax: int DB_FindRecord(DBBLOCK *dblk, char recordtype,
void far *searchstring, RECORDNUM begin, RECORDNUM end,
int flags, unsigned int *pos);
DB_NOTFOUND Find failed.