Renames a feature class definition in the feature-definition file attached to the current drawing.
AcMapObjClass::EErrCode RenameFeatureClassDefinition( const ACHAR* pszClassName, const ACHAR* pszNewClassName );
Parameters |
Description |
pszClassName |
Input current name of the feature class. |
pszNewClassName |
Input new name of the feature class. |
Returns AcMapObjClass::EErrCode eOk if successful. Returns AcMapObjClass::EErrCode eClassNotFound if the class is not in the feature-definition file. Returns AcMapObjClass::EErrCode eClassAlreadyExists if a class with the same name already exists. Returns AcMapObjClass::EErrCode eNoSchemaFileAttached if no feature-definition file is attached to the current drawing. Returns AcMapObjClass::EErrCode eClassNameInvalid if the class name is invalid. Returns AcMapObjClass::EErrCode eClassNameTooLong if the class name is too long. Returns AcMapObjClass::EErrCode eNoUserPrivilegeToAlterSchema if the current user lacks the privileges to change the feature-definition file. Returns AcMapObjClass::EErrCode eFailed if the process failed for some other reason.
The new name must be a non-empty string with 256 or fewer characters. The valid characters are: a-z A-Z 0-9 $ _ - (including accented characters). Entities classified with the renamed feature class are not updated; instead, they become undefined.