FTS Error Codes

<< Click to Display Table of Contents >>

Navigation:  Apollo VCL Components > Run-Time Errors >

FTS Error Codes

The following table lists all possible error values than can be returned from the FTS methods. The table lists each error code, its name, and a brief explanation of the error type. All FTS methods return a code equal to or greater than zero if the method succeeds. With the exception of the methods that return an FTS handle, you are not required to save or test the error return value, although it is strongly recommend that you do.

 

 

Name

Code

Explanation

FTS_CREATEFAIL

-1

File creation error. System was unable to create the file specified. Check that you are not trying to write over a protected file and that there is sufficient space on disk for the file.

FTS_MEMERR

-2

Memory allocation error. System was unable to allocate the memory requested during CreateIndex or Open. Try again with a smaller value for iBuffSize.

FTS_NULLPTR

-3

Function called with NULL pointer. You should never receive this error. If you do, please record all related information and contact Vista Software technical support.

FTS_BADSEEK

-4

Illegal Seek. There was an error while seeking into the FTS index file. A seek error indicates a serious malfunction in your program.

FTS_BADREAD

-5

Read error. An FTS method could not read the index file. Make sure the file was opened correctly.

FTS_BADWRITE

-6

Write error. An FTS method (Add or Replace) could not write to the index. Make sure the index was opened for reading and writing.

FTS_RECBOUND

-7

Record number out of bounds. The record value passed to Replace, Delete, IsDelete, or UnDelete is out of range. Either the value is less than 1 or greater than the total number of records in the index file.

FTS_ISDELETED

-8

Attempt to delete already deleted record. A call was made to Delete when the record has already been deleted.

Before attempting to delete an index record use IsDelete to determine if the record can be deleted.

FTS_NOTDELETED

-9

Attempt to undelete non-deleted record. A call was made to UnDelete when the record was not deleted. Before

attempting to undelete an index record use IsDelete to determine if the record is presently deleted.

FTS_OPENERR

-10

Unable to open FTS file. System was unable to open the file specified by the path parameter. Insure that the file does exist and it is not write protected or already opened in a mode that conflicts with the open mode used by your application.

FTS_INTERR

-11

Internal Error. You should never receive this error. If you do, please record all related information and contact technical support.

FTS_NORECS

-13

Setup called with empty FTS file. The index file specified does not contain any records. A search of it would be useless.

FTS_BADPARMS

-16

Illegal number or type of parameters. An invalid parameter has been passed to an FTS method. The most common cause of this error has been an incorrect MODE parameter to Open.

FTS_NOMOREHANDLES

-17

Ran out of FTS handles. FTS handles 0 thru 63 have all been used. Consider a redesign of the system.

FTS_BADHANDLE

-18

Invalid handle. Be sure the FTS index is opened properly; check to see that the application has not changed the value of the variable representing the FTS handle.

FTS_BADIHANDLE

-19

Invalid internal handle. You should never receive this error. If you do, please record all related information and contact Vista Software technical support.

FTS_LOCKFAILED

-20

Unable to lock file. An FTS write operation could not lock the index header or an index record prior to updating or adding a record. Either the record or header is locked by another process. Retry the operation.

FTS_NOMORELOCKS

-21

Lock table exhausted. The FTS internal lock table is full. This error should not occur during normal use of the library. You should never receive this error. If you do, please record all related information and contact Vista Software technical support.

FTS_CANNOTUNLOCK

-22

Unable to unlock file. An FTS method has attempted to unlock a region of the index file that was not previously locked. You should never receive this error. If you do, please record all related information and contact Vista Software technical support.

FTS_BADCOMMIT

-23

Unable to flush buffer to disk. An FTS method failed while attempting to flush internal buffers to disk. You should never receive this error. If you do, please record all related information and contact Vista Software technical support.