Soap.SOAPDm.TSoapDataModule.SAS_ApplyUpdates
Delphi
function SAS_ApplyUpdates(const ProviderName: OleStr; Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant; virtual; stdcall;
C++
virtual System::OleVariant __stdcall SAS_ApplyUpdates(const System::WideString ProviderName, 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.
SAS_SAS_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 BeforeSAS_ApplyUpdates event handler and returned to the client application in an AfterSAS_ApplyUpdates event handler. It is passed to the provider's BeforeSAS_ApplyUpdates event handler and returned from the provider's AfterSAS_ApplyUpdates event handler.
SAS_SAS_ApplyUpdates returns a Variant that is a data packet containing all records that could not be applied.
Note: Applications can only call the protected SAS_SAS_ApplyUpdates method using the IAppServerSOAP interface. To apply updates directly in code from the application server, use the provider component's SAS_ApplyUpdates method.