Commit Method of the DataSetTableRecords Object
This method commits all the changes you made to the records since the previous commit.
You can use this method only if the DocumentDefinition to which the data set belongs has been switched to editing mode by the CheckOut method. After one or several calls to this method, use the CheckIn method to save all the committed changes to the Document Definition or the UndoCheckout method to discard all the committed changes.
Visual Basic .NET
Function Commit(Callback As ProcessingEvents) As RejectedDatasetRecords
HRESULT Commit( IProcessingEvents* Callback, IRejectedDatasetRecords** RejectedRecords )
- [in] Refers to an object implementing the IProcessingEvents interface that will inform the user of the progress and errors that occurred while writing the data to the data set, and provide a way to abort the operation. You may pass NULL for this parameter.
- [out, retval] A pointer to IRejectedDataSetRecords* pointer variable that receives the interface pointer of the output RejectedDataSetRecords object. This object will contain all the data set records that failed to be written into the data set, with error messages explaining the reason for the failure.
A record may be rejected because of a non-unique value of the primary key field, an empty value of a required field, etc. For example, if you try to create a business unit record without specifying the CountryCode field, it will be rejected.
This method has no specific return values. It returns the standard return values of ABBYY FlexiCapture SDK functions.
This method is used in the following code samples: Invoices Processing and Training.