NAME

DsInqSafeFlag − Query the safe flag

SYNOPSIS

C:

DtFlag DsInqSafeFlag()

FORTRAN:

INTEGER∗4 DSQSF()

DESCRIPTION

DsInqSafeFlag queries the safe flag.  The safe flag is a debugging tool for the application programmer. 

When the safe flag is set to DcTrue <DCTRUE>, all deleted objects are treated so that any private data associated with the object is released as usual but the type of object is set to DcObjectDeleted <DCODEL>.  Whenever such an object is accessed, an error is generated and the user can determine why the illegal reference was made. 

If the flag is set to DcFalse <DCFALS>, both the object header and any private data of all deleted objects are freed immediately.  If the safe flag is changed from DcTrue <DCTRUE> to DcFalse <DCFALS>, all object headers of type DcObjectDeleted <DCODEL> are freed. 

An application should not refer to an object’s handle once the application has released the object using DsReleaseObj <DSRO>. 

SEE ALSO

DsSetSafeFlag(3D), DsReleaseObj(3D)

September 02, 1992