Sets whether a unique key value is created for each incoming entity. This setting is ignored unless an existing or new object data table already has been set with SetDataMapping(). The key column has type integer. In the AutoCAD Map user interface, this setting corresponds to the Add Unique Key Field check box in the Attribute Data dialog box.
virtual AcMapIE::ErrCode SetUseUniqueKeyField(
const ACHAR* pszKeyFieldName
) = 0;|
Parameters |
Description |
|
pszKeyFieldName |
Input name for key column. This name must follow the pre-Release 14 AutoCAD symbol-naming convention; that is, it can contain only alphanumeric, underscore, and hyphen characters. Multibyte characters are allowed. |
Returns AcMapIE::ErrCode kErr_OK if successful. Returns AcMapIE::ErrCode kErr_BadFieldName if the column name is invalid. Returns AcMapIE::ErrCode kErr_Invalid if a column with the same name already exists as an input column. (This situation is not necessarily a problem, but it could render other import-related error reports and actions confusing.) Returns AcMapIE::ErrCode kErr_ConflictWithTarget if the column name already exists as a mapped target column name. Returns AcMapIE::ErrCode kErr_Fail if the process failed for some other reason.