InsertB

Purpose
Used to insert a new record into the database.

Syntax (Method)
object.Insert Key, Data, KeyBefore

Parameters

Key (String)		The new record's key is assigned this value.
Data (Byte Array)		The new record's data is assigned this value.
KeyBefore (String)		The new record is inserted just before the existing record containing this key.

Notes
This method allows duplicate keys to exist in the database. Hence, if this method is called with a key (Key) that already exists in the database, a new record will still be inserted with the specified key (Key).

Error Values
After calling this method, the property ErrorNumber will report one of the following values:

rtCDP_ErrNoError
rtCDP_ErrKeyTooLong
rtCDP_ErrDataTooLong
rtCDP_ErrRecordNotFound
rtCDP_ErrDatabaseFull

Example
See Insert.

Version History
1.0 1/30/2001 Tested

See Also
Insert, InsertArray, InsertArrayB, InsertRec, InsertRecB