EssGGetRows

Description

EssGGetRows() retrieves data after an operation has been completed.

Syntax

ESSG_FUNC_M EssGGetRows (hGrid, ulOptions, pRangeRequested,
pRangeOut, pppDataOut);
ESSG_HGRID_T hGrid
ESSG_ULONG_T ulOptions
ESSG_PRANGE_T pRangeRequested
ESSG_PRANGE_T pRangeOut
ESSG_PPDATA_T *pppDataOut

Parameters

hGridHandle passed back from EssGNewGrid.
ulOptionsReserved for future use. Should be set to zero.
pRangeRequestedDescribes the extent of the data requested. This can be less than or equal to the number of rows and columns returned from the EssGGetResults call.
pRangeOutDescribes the extent of the data returned.
pppDataOutThe address of a two-dimensional array of data. The memory for this array is allocated by the API and should be freed by the caller using EssGFreeRows.

Return Value

If successful, returns ESSG_STS_NOERR.

Notes

Access

None.

Example

         sts = EssGGetRows(hGrid, 0, &rDataRangeOut, 
         &rDataRangeOut, &ppDataOut);

See an example that uses this code in the EssGBeginRetrieve Example section.

See Also

Using the Grid API Functions
Grid API Structures