NAME

DsInqObjClassId − Return an object’s class id from its object handle

SYNOPSIS

C:

DtInt DsInqObjClassId(object)
DtObject object;

FORTRAN:

INTEGER∗4 DSQOCI(OBJECT)
INTEGER∗4 OBJECT

DESCRIPTION

DsInqObjClassId finds an object’s class id given its object handle.  The parameter object specifies the object. 

When an object is created, it is assigned a class that is identifiable by both an integer class identification number and a class name.  The class identifier can be determined from an object’s handle using DsInqObjClassId, or from the class name using DsInqClassId <DSQCI>.  By convention, the class name is the C Language name of the routine used to create an object of that class; for example, an object created with DoPolygon is of class “DoPolygon”. 

ERRORS

DsInqObjClassId will fail if the object handle is invalid; a -1 is returned. 

[WARNING - invalid or deleted object]

SEE ALSO

DsInqClassId(3D)

September 02, 1992