Parameter Type Description
inObject Longint inTag String outBLOB BLOB A handle to an object
→ Tag of the item to retrieve → The retrieved item ←
Discussion
OT GetBLOB gets a value in inObject from the item referenced by inTag.
If the object is not a valid object handle, an error is generated, OK is set to zero, and an empty BLOB is returned.
If no item in the object has the given tag, an empty BLOB is returned. If the FailOnNoItem option is set, an error is generated and OK is set to zero.
If an item with the given tag exists and has the type Is BLOB, outBLOB’s contents are replaced.
If an item with the given tag exists and has any other type, OK is set to zero, and an empty BLOB is returned.
Warning Do not attempt to pass a BLOB field or a dereferenced pointer to a BLOB field in the blob paremeter, as this will result in a crash. If you want to retrieve a BLOB item into a field, either use an intermediate local variable or assign the result of OT GetNewBLOB to the field. The same applies to passing a dereferenced pointer to a BLOB variable.
This command is being kept for backward compatibility. Because of the problems related to this command, it is recommended that you use OT GetNewBLOB instead, as this command may be removed in future versions.
See Also