GetRecord - Parameter inObject LongintA handle object inTag Stringrarr Tag item retrieve rarr Discussion OT GetRecord sets current record table from packed record data item referenced inTag contents item have been set OT PutRecord table used store packed record table have its current record set If object not valid object handle error generated OK set zero If item object given tag nothing happens If item given tag exists type OT Record current record itemrsquos original table set If current record itemrsquos table current record locked error generated OK set zero Warning Once record stored PutRecord retrieved same table Otherwise results unde64257ned and potentially disastrous use GetRecordTable command source table stored record See

OT GetRecord

Parameter Type Description

inObject Longint A handle to an object

inTag String ^→Tag of the item to retrieve →

Discussion

OT GetRecord sets the current record of a table from the packed record data in the item referenced by inTag. The contents of the item must have been set with OT PutRecord. The table used to store the packed record is the table which will have its current record set.

If object is not a valid object handle, an error is generated and OK is set to zero.

If no item in object has the given tag, nothing happens.

If an item with the given tag exists and has the type OT Is Record, the current record of the item’s original table is set.

If there is no current record for the item’s table or the current record is locked, an error is generated and OK is set to zero.

Warning Once a record is stored with OT PutRecord, it must be retrieved into the same table. Otherwise the results are undeﬁned (and potentially disastrous). You can use the OT GetRecordTable command to ﬁnd the source table for a stored record.

See Also

OT PutRecord, OT GetRecordTable

Topics of Interest
OT GetRecordTable
OT PutRecord

Published date: Fri, 14 Jul 2006 18:39:05 GMT → View XML Version

Edit this page now