PutRecord - Parameter Type Description inObject Longint handle object inTag String rarr Tag item set inTable TableField pointer rarr Table whose record rarr store Discussion OT PutRecord puts current record object packed format contents item only retrieved OT GetRecord If inObject not valid object handle error generated OK set zero If item object given tag new item created If item given tag exists type OT Record its value replaced If item given tag exists other type error generated OK set zero If table not valid table pointer current record given table error generated OK set zero OT VariantItems option not set otherwise existing item deleted new item created Warning Once record stored PutRecord retrieved same table Otherwise results unde64257ned and potentially disastrous See

OT PutRecord

Parameter Type Description

inObject Longint A handle to an object inTag String ^→Tag of the item to set inTable Table/Field pointer ^→Table whose record you want to → store

Discussion

OT PutRecord puts the current record into object in a packed format. The contents of the item can only be retrieved with OT GetRecord.

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

If no item in the object has the given tag, a new item is created.

If an item with the given tag exists and has the type OT Is Record (115), its value is replaced.

If an item with the given tag exists and has any other type, an error is generated and OK is set to zero.

If table is not a valid table or ﬁeld pointer, or if there is no current record for the given table, an error is generated and OK is set to zero if the OT VariantItems option is not set, otherwise the existing item is deleted and a new item is created.

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).

See Also

OT GetRecord, OT GetRecordTable

Topics of Interest
OT GetRecord
OT GetRecordTable

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

Edit this page now