BltDataUpdateRecord


< Prev  TOC  Next >

TBLT_RETC TBLT_ENTRY BltDataUpdateRecord(TBLT_DH *dhPtr,
                                         ULONG recNo,
                                         VOID *recordPtr);


 dhPtr          I:data file control structure
 recNo          I:number of record to write
 recordPtr      I:record to write to recNo

This routine overwrites an existing data record with new record data.

Bullet writes at the record-granular level. This routine updates an entire data record. To change part of a record, first read in the record with BltDataGetRecord(), modify the field, then write it back out using this routine.

Caution: This routine, as with all BltData*() routines, is not index-aware. Making a change to a data record where that change affects the index should not be performed at this level. Instead, use BltIx4Update(), which handles any needed updating of the index file automatically.

Return: Non-zero indicates an error, otherwise the record is updated.




All content Copyright © 1999 Cornel Huth. All rights reserved.