|
<< Click to Display Table of Contents >>
_BtUpdate() Function
|
  
|
_BtUpdate() Function
|
<< Click to Display Table of Contents >>
_BtUpdate() Function
|
|
Purpose
Write changes to a record back to disk
Prototype
FUNCTION _BtUpdate ( hFile AS PTR, PtrData AS PTR, nRecLen AS WORD, ptrKey AS PTR, nKeyNum AS BYTE ) AS LOGIC
Argument(s)
| <hFile> | File handle that was returned by _BtOpen |
| <ptrData> | Pointer to the databuffer that you want to fill |
| <nRecLen> | Length of the data structure. This value must be at least as long as the fixed-length portion of the record. |
| <ptrKey> | Pointer to the Key buffer. Allocate BSIMAX_KEY_SIZE for this buffer |
| <nKeyNum> | Key Number, first key is numbered 0. Specify a value of 0xFF if you want no currency change to occur. |
Return
| LOGIC | TRUE when the update was succesfull, otherwise FALSE |
Description
If the Update operation is unsuccessful, the Bt_Error() function may RETURN one of the following status codes:
| 05 | Duplicate Key Value |
| 08 | Invalid Positioning |
| 10 | Modifiable Key Value Error |
| 14 | Pre-Image Open Error |
| 15 | Pre-Image I/O Error |
| 22 | Data Buffer Length |
| 80 | Conflict |
| 83 | Read Outside Transaction |