acdbRegApp

C++

int acdbRegApp(
    const ACHAR * appname
);

File

acedads.h

Description

Registers the application's extended entity data.

Registers an application name in the current drawing. Application names are used for grouping, storing, retrieving, and modifying extended entity data. An application can register as many names as necessary (or none at all), but the names it registers should be unique to that application.

Application names must adhere to the rules for symbol table names (such as layer names).

If the name has not been registered before, acdbRegApp() adds appname to the APPID symbol table of the current drawing and returns RTNORM. If appname is already in the APPID table, acdbRegApp() returns RTERROR. When acdbRegApp() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Do not call acdbRegApp() from within the AcRx::kInitAppMsg handler because acdbRegApp() has to be database (document) specific. Instead, either call acdbRegApp() from the kLoadDwgMsg handler or use the AcDbRegAppTableRecord or AcDbRegAppTable classes directly.

Parameters