acdbHandEnt

C++

int acdbHandEnt(
    const ACHAR * handle, 
    ads_name entres
);

File

acdbads.h

Description

Finds the entity with the specified handle.

An entity's name changes whenever AutoCAD opens the drawing, but the entity's handle is constant throughout its life. An ARX application that manipulates a specific database can use acdbHandEnt() to obtain the current name of an entity that the application must manipulate. Once the name is obtained, the entity can be handled by using the other entity functions.

The acdbHandEnt() function will find entities deleted during the current editing session. Another use of this function is to find such entities and undelete them, if necessary, with the acdbEntDel() function.

If acdbHandEnt() succeeds, it returns RTNORM. If handles are disabled, if handle is not a valid handle string, or if handle cannot be found in the current database, acdbHandEnt() returns RTERROR. When acdbHandEnt() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters