smc_get_row_count

Description

Returns the number of rows returned by a given view after a refresh.

Syntax

SMC_RETURN_CODE smc_get_row_count
 (SMC_CONNECT_ID     clientId,
 	SMC_VIEW_ID        viewId,
 	SMC_SIZETP         rowCountHandle)

Parameters

clientId

identifies the connection.

viewId

identifies a view created on the connection.

rowCountHandle

pointer to a variable into which Monitor Client Library writes the number of rows in a view.

Returns

Return value

Indicates

SMC_RET_SUCCESS

Function succeeded.

SMC_RET_FAILURE

Function failed.

SMC_RET_INVALID_CONNECT

Connection does not exist.

Examples

Example 1

The following example assumes that:

Usage

The first row of data is indexed by row number 0, the second by 1, and so on.


Valid server modes

Mode

Availability

SMC_SERVER_M_LIVE

Yes

SMC_SERVER_M_HISTORICAL

Yes (during playback)


Error

Error

Indicates

SMC_RET_INVALID_VIEWID

View does not exist.

See also

smc_refresh_ex, smc_get_dataitem_value