Soap.SOAPDm.TSoapDataModule.SAS_Execute

From RAD Studio API Documentation
Jump to: navigation, search


Delphi

procedure SAS_Execute(const ProviderName: OleStr; const CommandText: OleStr;  var Params: OleVariant; var OwnerData: OleVariant); virtual; stdcall;

C++

virtual void __stdcall SAS_Execute(const System::WideString ProviderName, const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData);

Properties

Type Visibility Source Unit Parent
procedure
function
protected
Soap.SOAPDm.pas
Soap.SOAPDm.hpp
Soap.SOAPDm TSoapDataModule

Description

SAS_Execute executes the query or stored procedure bound to a specified provider.

Use SAS_SAS_Execute to pass an execute command to a remote provider, using a specified set of parameters. SAS_SAS_Execute calls SAS_Execute, which calls the SAS_Execute method of the specified provider after assigning any parameters. Output parameters that result from executing a query or stored procedure are returned in the Params parameter.

Note: SAS_SAS_Execute should only be called for a provider whose dataset represents a query or stored procedure that does not return a cursor.

ProviderName specifies the name of the provider component associated with the query or stored procedure.

CommandText specifies an optional SQL statement that replaces the SQL of the provider's query, or the name of a stored procedure that replaces the provider's underlying stored procedure. This parameter is ignored if the Options property does not include poAllowCommandText.

Params encodes any parameters expected by the query or stored procedure and returns any output parameters. To create a properly encoded value for Params from a TParams object, use the PackageParams method.

OwnerData contains custom information that appears as an argument to the provider's BeforeSAS_Execute and AfterSAS_Execute event handlers. This information originates in a client dataset's BeforeSAS_Execute event handler. The value returned in OwnerData is passed to the client dataset's AfterSAS_Execute event handler.

Note: Applications can only call the protected SAS_SAS_Execute method using the IAppServerSOAP interface. To execute a dataset in code from the application server, use the dataset component directly.

See Also