Function
Indicates that there is a reference to a specified Object.
Syntax
#include <dx/dx.h>
Object DXReference(Object o)
Functional Details
Indicates that there is a reference to Object o. The Object is guaranteed to not be deleted until this reference is released, using the DXDelete routine.
In general, one does not need to use DXReference, because the Data Explorer library routines such as DXSetMember and DXSetComponentValue manage an Object's reference count themselves.
Objects returned to the executive by modules should not be referenced. Objects returned to the executive are considered "owned" by the executive, and so it references these Objects.
Return Value
Returns o, or returns NULL and sets the error code to indicate an error.
See Also
DXDelete, DXSetCacheEntry, DXSetCacheEntryV, DXUnreference
[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]