GetFullStateBlob

Description

Returns the state of a DataWindow or DataStore. You must call GetFullState first to set up the state information. This method is used primarily in distributed applications.

Applies to

DataWindow type

Method applies to

Web ActiveX

DataWindow control

Syntax

Web ActiveX

string dwcontrol.GetFullStateBlob ( ) 

Argument

Description

dwcontrol

A reference to the DataWindow control for which you just called GetFullState

Returns

Returns a string whose value is the DataWindow state blob set up by GetFullState.

If dwcontrol is null, the method returns null.

Usage

GetFullState and GetFullStateBlob are used in conjunction with SetFullState to synchronize two or more DataWindows or DataStores. For details, see GetFullState.

Examples

Example 1

These statements use GetChanges to capture changes to a DataWindow control on a client. If GetChanges succeeds, the client calls a remote object function that applies the changes to a DataStore on the server and updates the database:

blob lblb_changes

long ll_rv


ll_rv = dw_employee.GetChanges(lblb_changes)


IF ll_rv = -1 THEN

		MessageBox("Error", "GetChanges call failed!")

ELSE

		iuo_employee.UpdateData(lblb_changes)

END IF

See also