EssGBeginUpdate() this function begins an update of data at the server. This function returns no data to the caller.
ESSG_FUNC_M EssGBeginUpdate (hGrid, ulOptions);
| ESSG_HGRID_T | hGrid |
| ESSG_ULONG_T | ulOptions |
| hGrid | Handle passed back from EssGNewGrid. |
| ulOptions | A constant which
indicates whether the blocks must be previously locked or not prior to update.
One of the following mutually exclusive values must be used:
|
If successful, returns ESSG_STS_NOERR.
None.
ESSG_VOID_T ESSG_BeginUpdate (ESSG_HGRID_T hGrid)
{
ESSG_FUNC_M sts = ESS_STS_NOERR;
ESSG_PPDATA_T ppDataIn;
ESSG_RANGE_T rDataRangeIn;
ESSG_ULONG_T ulOptions;
/* connect the grid to a database on the server */
sts = EssGConnect(hGrid, "Rainbow", "Admin",
"Password", "Demo", "Basic", ESSG_CONNECT_NODIALOG);
if(sts == 0)
{
ppDataIn = BuildTable(&rDataRangeIn);
ulOptions = ESSG_LOCKIFNEEDED;
/* start the update operation */
sts = EssGBeginUpdate(hGrid, ulOptions);
}
if(sts == 0)
{
/* send the entire grid to define the query */
sts = EssGSendRows(hGrid, &rDataRangeIn, ppDataIn);
}
if(sts == 0)
{
/* perform the update */
sts = EssGPerformOperation(hGrid, 0);
/* free the built data */
FreeTwoDim(ppDataIn, rDataRangeIn.ulNumRows);
}
if(!sts)
{
EssGEndOperation(hGrid, 0);
EssGDisconnect(hGrid, 0);
}
}