Release Date: 1 February 2008
Namedt_thor_tdtremove - remove a TDT from a database
Generic Prototypedt_thor_tdtremove(dt_Handle) => dt_Integer
C Prototype#include "dt_thor.h"
dt_Integer dt_thor_tdtremove(dt_Handle tdt)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
DescriptionPermanently removes a TDT from the database. Does not affect the TDT object representing that same TDT, which may have been retrieved from the database. The TDT object should be deallocated separately using dt_dealloc(3) when it is no longer needed.
If record locking is enforced (see dt_thor_settdtlocking(3)), and the record is locked, the record will appear to this client to be deleted, but other clients will still "see" the record until the delete is "committed" (the record is unlocked). Locked records that are deleted can be also "rolled back" (the record undeleted) up to the point where is it "committed" (see dt_thor_tdtput(3)).
Return ValueIf the TDT is found and removed, returns 1. If the TDT is not found, returns zero. If an error is detected, returns -1. When an error is detected, the TDT may or may not be removed from the database.
Related Topicsdt_thor_settdtlocking(3) dt_thor_tdtget(3) dt_thor_tdtget_raw(3) dt_thor_tdtmerge(3) dt_thor_tdtput(3) dt_thor_tdtput_raw(3) dt_thor_tdtremove_raw(3) dt_thor_tdtrevise(3) dt_thor_xrefget(3)