This function returns the next data record referenced by the ResultsHandle. The ResultsHandle references a set of records selected by an invocation of the CSSM_DL_DataGetFirst function.

The record values are returned in the Attributes and Data parameters. A flag indicates whether additional records satisfying the original query remain to be retrieved. The function also returns a unique record identifier for the return record.

CSSM_DB_UNIQUE_RECORD_PTR CSSMAPI CSSM_DL_DataGetNext 
                (CSSM_DL_DB_HANDLE DLDBHandle,
                CSSM_HANDLE ResultsHandle,
                CSSM_BOOL *EndOfDataStore,
                CSSM_DB_RECORD_ATTRIBUTE_DATA_PTR Attributes,
                CSSM_DATA_PTR Data)

Input

DLDBHandle

The handle pair that describes the DL module to be used to perform this function and the open data store from which records were selected by the initiating query.

Output

ResultsHandle

The handle identifying a set of records retrieved by a query executed by the CSSM_DL_DataGetFirst function.

EndOfDataStore

A flag indicating whether a record satisfying this query was available to be retrieved in the current operation. If CSSM_FALSE, then a record was available and was retrieved unless an error condition occurred. If CSSM_TRUE, then all records satisfying the query have been previously retrieved and no record has been returned by this operation.

Attributes

A list of attributes values (and corresponding meta-information) from the retrieved record.

Data

The opaque object stored in the retrieved record.

If successful and EndOfDataStore is CSSM_FALSE, this function returns a pointer to a CSSM_UNIQUE_RECORD structure containing a unique record locator and the record. If the pointer is NULL and EndOfDataStore is CSSM_TRUE, then a normal termination condition has occurred. If the pointer is NULL and EndOfDataStore is CSSM_FALSE, then an error has occurred. Use CSSM_GetError to obtain the error code.