Soap.SOAPDm.TSoapDataModule.SAS_RowRequest

From RAD Studio API Documentation
Jump to: navigation, search


Delphi

function  SAS_RowRequest(const ProviderName: OleStr; Row: OleVariant; RequestType: Integer;  var OwnerData: OleVariant): OleVariant; virtual; stdcall;

C++

virtual System::OleVariant __stdcall SAS_RowRequest(const System::WideString ProviderName, System::OleVariant Row, int RequestType, System::OleVariant &OwnerData);

Properties

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

Description

Returns information from a specified record of the provider's dataset.

Client datasets call SAS_SAS_RowRequest automatically to implement their FetchBlobs, FetchDetails , or RefreshRecord method.

ProviderName indicates the provider associated with the dataset from which information should be fetched.

Row is an OleVariant that describes the current record on the client dataset.

RequestType indicates the type of information required. It is an integer version of the TFetchOptions type. (An integer because the value may be marshaled to a remote application server). To create a value for RequestType, take the corresponding TFetchOptions value, cast it to a Byte, and cast the result to an Integer:



Integer(Byte([foBlobs, foDetails]));



(int) (Byte) (TFetchOptions() << foBlobs << foDetails);



OwnerData contains custom information that is supplied by a client dataset's BeforeSAS_RowRequest event handler. This information is passed to the provider's BeforeSAS_RowRequest event handler. OwnerData returns custom information supplied by the provider's AfterSAS_RowRequest event handler.

The requested data is returned as a delta packet.

Note: Applications can only call the protected SAS_SAS_RowRequest method using the IAppServerSOAP interface.

See Also