DsInqObjName(3D)

NAME
DsInqObjName - Obsolete function replaced by DsInqObjNameType, DsInqObjNameInteger and DsInqObjNameString

SYNOPSIS
C:
void DsInqObjName(object, object_name_type,
		object_name)
DtObject object;
DtNameType *object_name_type;
DtPtr object_name;

FORTRAN:
INTEGER*4 DSQONT(OBJECT)
INTEGER*4 OBJECT

INTEGER*4 DSQONI(OBJECT)
INTEGER*4 OBJECT

CALL DSQONS(OBJECT, FNAME, LENGTH)
INTEGER*4 OBJECT
INTEGER*4 LENGTH
CHARACTER*LENGTH FNAME

DESCRIPTION
DsInqObjName returns an object's name given its object handle. The parameter object specifies the object. The parameter object_name is for the returned object name. The parameter object_name_type returns the type of the object name that is passed back. Possible return values for object_name_type are:

DcNameInteger <DCNINT>
    An integer value name.

DcNameString <DCNSTR>
    A string value name. Object names are delimited by a trailing null.

DcNameNone <DCNNON>
    No name given.

Dore maintains a system wide object name table subdivided by class. The DsInqObjName function can obtain the name of any object in this table.

FORTRAN SPECIFIC

DSQONT returns the class (object type) of the object OBJECT.

DSQONI returns the name of the object OBJECT. This function should be used when the object name is of type DCNINT (it's an integer).

DSQONS returns the name of the object OBJECT. This function should be used when the object name is of type DCNSTR (it's a string). The string name is returned in FNAME and is LENGTH characters long.

ERRORS
DsInqObjName will fail if the object handle is invalid.

[WARNING - invalid or deleted object]

SEE ALSO
DsInqObj(3D)