Retrieving the Values of Scalars

After your application gets the handle to a folder, your application can retrieve the scalars for that folder. The SmsGetNextScalar and SmsGetScalarByName functions retrieve the specified scalar from the folder and write the scalar's information into a SCALAR structure. Using these two functions, your application can retrieve scalars in sequence or by the scalar name:

Note that the SmsGetScalarCount function returns the count of scalars within a folder.

Example

There are four types of scalars: SCALAR_INT, SCALAR_STRING, SCALAR_TIME, and SCALAR_BINARY. The following examples show how to retrieve the value for each type of scalar:

Example of Retrieving a SCALAR_INT Scalar

Example of Retrieving a SCALAR_STRING Scalar

Example of Retrieving a SCALAR_BINARY Scalar

Example of Retrieving a SCALAR_TIME Scalar