PM_DataRecordDuplicate

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

Const.PM_DataRecordDuplicate

The PM_DataRecordDuplicate message is sent to a data source to duplicate the current record.

Parameters

Name	Description
nWhat = wParam	Standard method parameter. Possible values are Const.METHOD_Inquire, Const.METHOD_Execute, Const.METHOD_GetType
lParam	Unused

Returns

When nWhat = Const.METHOD_Inquire, TRUE is returned if the new method is enabled and a record is currently selected, FALSE otherwise.

When nWhat = Const.METHOD_Execute, TRUE is returned if the record was successfully duplicated, FALSE otherwise.

Comments

Duplicating a record is performed in three steps:

Save the values of fields in the current record
Create a new record
Write the saved value to the fields in the new record

When performing step 3, the framework will only set the value of:

Insertable and updateable attribute (non-key) fields
Insertable, updateable, and empty (has no value) key fields

The reason attribute and key fields are treated differently is to avoid overwriting any server-default values in key fields (e.g. automatically generated id's).