Share

AcDbDatabase::getAcDbObjectId

C++

ACDBCORE2D_PORT Acad::ErrorStatus getAcDbObjectId(
    AcDbObjectId& retId, 
    bool createIfNotFound, 
    const AcDbHandle& objHandle, 
    Adesk::UInt32 xRefId = 0
);

Description

Fills in retId with the objectId of the object that has the handle value contained in objHandle. If createIfNotFound is true and the handle is not found in the database, then a new objectId stub object is created using the handle sought.

Use of the createIfNotFound argument is intended for AutoCAD internal use only (there is no way for an ObjectARX program to do anything with a objectId stub object that is not associated with any database object), so ObjectARX programs should always set this argument to false.

Returns Acad::eOk if successful. If createIfNotFound is set to false and the handle is not found, then Acad::eUnknownHandle is returned.

Parameters

Parameters Description
retId Output objectId value obtained by this function
createIfNotFound Input Boolean indicating to create a objectId stub if input handle is not found
objHandle Input AcDbHandle object containing the handle being passed in
xRefId Reserved for future use

Links

AcDbDatabase Class

Was this information helpful?