Soap.SOAPDm.TSoapDataModule.AS_ApplyUpdates
Delphi
function AS_ApplyUpdates(const ProviderName: OleStr; Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant; safecall;
C++
HRESULT __safecall AS_ApplyUpdates(const System::WideString ProviderName, System::OleVariant Delta, int MaxErrors, /* out */ int &ErrorCount, System::OleVariant &OwnerData, System::OleVariant &__AS_ApplyUpdates_result);
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.
AS_ApplyUpdates 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.
Note: In Delphi, AS_ApplyUpdates returns a Variant that is a data packet containing all records that could not be applied.
Note: In C++, the AS_ApplyUpdates _result parameter returns the Variant containing the data packet.
Note: Applications can only call the protected AS_ApplyUpdates method using the IAppServer interface. To apply updates directly in code from the application server, use the provider component's AS_ApplyUpdates method.