Soap.SOAPDm.TSoapDataModule.AS_RowRequest

From RAD Studio API Documentation
Jump to: navigation, search


Delphi

function AS_RowRequest(const ProviderName: OleStr; Row: OleVariant;  RequestType: Integer; var OwnerData: OleVariant): OleVariant; safecall;

C++

HRESULT __safecall AS_RowRequest(const System::WideString ProviderName, System::OleVariant Row, int RequestType, System::OleVariant &OwnerData, System::OleVariant &__AS_RowRequest_result);

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 AS_AS_RowRequest automatically to implement their FetchBlobs, FetchDetails, or RefreshRecord methods.

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

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

The RequestType parameter 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 BeforeRowRequest event handler. This information is passed to the provider's BeforeRowRequest event handler. OwnerData returns custom information supplied by the provider's AfterRowRequest event handler.

The requested data is returned as a delta packet.

Note: Applications can only call the protected AS_RowRequest method using the IAppServer interface.

See Also