TSoapDataModule.SAS_ApplyUpdates Method

Applies updates received from a client using a specified provider.

Pascal

function SAS_ApplyUpdates(const ProviderName: WideString; Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer; var OwnerData: OleVariant): OleVariant; virtual; stdcall;

C++

virtual __fastcall __stdcall OleVariant SAS_ApplyUpdates(const BSTR ProviderName, OleVariant Delta, int MaxErrors, int ErrorCount, OleVariant OwnerData);

Description

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.