PM_DataSourceSave

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_DataSourceSave

Applications and the framework send the Const.PM_DataSourceSave message to a data source in order to save any changes made.

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, the return value is TRUE if there are any changes to save in the data source or any of it's child data sources.

When nWhat = Const.METHOD_Execute, the return value is TRUE if the entire save transaction was successfully ended (committed), FALSE otherwise.

Comments

When saving changes, the database transaction and the main flow are controlled by the master data source in the master-detail chain. The master data source calls upon the detail data source to save removed records, new records etc.