When reading a collection of notes, your program might need to issue the read notes request more than once to read all of the candidate notes. If the answer area and buffer area (as applicable) are large enough to hold all of the selected notes, only one read request is needed. However, if the supplied storage areas are not large enough to hold all of the selected notes, you must reissue the request to continue reading the remaining notes. A return code of zero implies that the read is complete. A return and reason code indicating more notes implies that the read request completed prematurely and needs to be reissued. Each reissued request must provide as input the resume token that was returned by its predecessor request.

Note that when a multi-note read request completes with return code 0, the number of notes reported could be zero. Furthermore, a return and reason code indicating more notes does not imply that any of the remaining notes will meet the selection criteria. In effect, complete and more notes indicate whether XCF has finished inspecting the notes in the note pad.