DsInqSafeFlag(3D)

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)