Soap.SOAPDm.TSoapDataModule.ApplyUpdates
Delphi
function ApplyUpdates(const ProviderName: OleStr; Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant;
C++
System::OleVariant __fastcall ApplyUpdates(const System::WideString ProviderName, const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount, System::OleVariant &OwnerData);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | protected | Soap.SOAPDm.pas Soap.SOAPDm.hpp |
Soap.SOAPDm | TSoapDataModule |
Description
Applies updates received from a client using a specified provider.
ApplyUpdates provides the underlying implementation for the AS_ApplyUpates method (on the IAppServer interface) and the SAS_ApplyUpdates method (on the IAppServerSoap interface). It writes client updates to a dataset or database server.
ProviderName specifies the name of the provider component that manages the update operation.
Delta is a Variant containing the updated, inserted, and deleted records to write to the database.
MaxErrors indicates the maximum number of errors to permit before rolling back the update operation
ErrorCount returns the actual number of errors encountered during the update operation.
OwnerData is information supplied by the client application in a BeforeApplyUpdates event handler and returned to the client application in an AfterApplyUpdates event handler. It is passed to the provider's BeforeApplyUpdates event handler and returned from the provider's AfterApplyUpdates event handler.
ApplyUpdates returns a Variant that is a data packet containing all records that could not be applied.