READ_MULT: Reading Multiple List Entries from One or More Lists

With the READ_MULT request you can read multiple list entries in the structure and filter their selection by list number, version number, list authority value, entry key value, or any combination of these filters. Note that if another user adds or updates a list entry while your request is being processed, these changes might not be included in the output you receive. You cannot assume that your READ_MULT request has read every list entry that meets your selection criteria unless you serialize access to the list structure before issuing the request and prevent other users from changing the list structure while your request is being performed.

The READ_MULT request has the following features:

You can read list entries from multiple lists
The order in which a list entry is read and returned in the buffer has no relationship to its position in the list structure.
Since the order in which list entries are read is unpredictable, it is also unpredictable whether an entry, added after the scan has begun, will be found.
The list service returns a restart token in the answer area when a READ_MULT request ends prematurely. Unlike a READ_LIST request, a prematurely completed READ_MULT request can be resumed successfully regardless of whether list entries have been moved or deleted. Entries will not be read twice or skipped.

Note: For reading list entries from a single list, the READ_LIST request provides better performance.