smc_get_dataitem_value

Description

Returns data after a refresh. This data is returned one data item of one row at a time.

Syntax

SMC_RETURN_CODE smc_get_dataitem_value
 (SMC_CONNECT_ID          clientId,
 	SMC_VIEW_ID             viewId,
 	SMC_DATAITEM_STRUCTP    dataItemHandle,
 	SMC_SIZET               row,
 	SMC_VALUE_UNIONP        returnVal)

Parameters

clientId

identifies the connection.

viewId

identifies a view created on the connection.

dataItemHandle

pointer to data item and statistic type.

row

row number of requested data.

returnVal

return value that contains the value of one data item.

Returns

Return value

Indicates

SMC_RET_SUCCESS

Function succeeded.

SMC_RET_FAILURE

Function failed.

SMC_RET_INVALID_CONNECT

No connection exists with the specified ID.

Examples

Example 1

The following example assumes that:

Usage


Errors

Error

Indicates

SMC_RET_INVALID_VIEWID

View does not exist.

SMC_RET_INVALID_DINAME

Invalid data item.

SMC_RET_INVALID_DISTAT

Invalid data item statistic type.

SMC_RET_INVALID_PARAMETER

Invalid parameter.

See also

smc_refresh_ex, smc_get_dataitem_type