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 field in the object header 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>, all deleted objects are freed immediately, both the object header and any private data.  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)

September 29, 2021