Function
Deletes a reference to an Object.
Syntax
#include <dx/dx.h>
Error DXDelete(Object o)
Functional Details A call to this routine indicates that Object o is no longer needed. A reference count is maintained inside each Object; the memory associated with each Object o is not actually released until the last user of Object o has called DXDelete. If o is NULL, then DXDelete immediately returns OK.
When DXDelete is called on Objects that contain other objects (e.g., Groups or Fields), it decrements the reference count on all Objects in the hierarchy. A module that creates an Object is responsible for deleting the Object unless it is either made part of another Object (e.g, using DXSetComponentValue) or it is returned as the module output.
Return Value
Returns OK or returns ERROR and sets an error code.
See Also
4.2 , "Memory Management", "Object Routines".
[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]