QMReadNext()

Top  Previous  Next

 

The QMReadNext() function retrieves the next entry from a select list

 

 

Format

 

VBQMReadNext(ByVal ListNo as Integer, ByRef Errno as Integer) as String

 

Cchar * QMReadNext(int ListNo)

 

ObjStr = Session->ReadNext(ListNo)

 

where

 

ListNois the number of the select list to be processed in the range 0 to 10.

 

Errnoreceives an error value indicating the outcome of the request. The C API does not have this argument and returns NULL if an error occurs.

 

 

The QMReadNext() function retrieves the next entry from the select list identified by the ListNo argument.

 

If successful, the function returns the list entry and, in the Visual Basic API, Errno is set to SV_OK.

 

If the list is empty, the Visual Basic API function returns a null string and Errno is set to SV_ELSE. In the C API implementation, the function returns NULL.

 

 

See also the QMReadList() function for a discussion of the relationship between QMReadNext() and QMReadList().

 

 

Note that in the C API library, the returned string is dynamically allocated. A loop containing a call to this function must free the memory from each call separately.