Issue a delete notes request to delete the collection of notes defined by the specified selection criteria. XCF scans the note pad, inspecting each note to see if it satisfies the selection criteria. Each note that satisfies the selection criteria is deleted. A valid delete request returns when all the notes in the note pad have been inspected.

An answer area is optional. If provided, a count of the number of notes deleted by the request is stored in the answer area upon successful completion. Only the answer area header is needed. A delete notes request does not support "read and delete", so no space is needed in the answer area for note data records and a buffer area is not supported.

Take note of the discussion of Concurrent request issues. In particular, the delete notes request scans the notes in the note pad in created timestamp order. If your program concurrently creates notes while the delete notes request is being processed, the timing of the interplay between these requests could be such that the delete notes request might fail to delete a note that satisfies the selection criteria. Your program might need to account for this possibility.