Function : ID Table

IDScan - Sequentially return each ID in an ID Table.
----------------------------------------------------------------------------------------------------------

#include <idtable.h>

BOOL LNPUBLIC IDScan(
DHANDLE hTable,
BOOL fFirst,
DWORD far *retID);

Description :

This function takes a HANDLE to an ID Table and a BOOL argument indicating whether or not you are asking for the first note ID in the table. It returns either the first or next available note ID as requested.

ID Tables are ordered by value. IDScan returns Note IDs in the order they appear in the ID Table.

Parameters :

Sample Usage :

    /*  Loop over note IDs in the table. Call ProcessNote on each. */
   fFirst = TRUE;

   while(IDScan(hNoteIDTable, fFirst, &NoteID))
   {
       fFirst = FALSE;
       printf ("\tProcessing note %lX.\n", NoteID);
       if (error = ProcessNote(NoteID))
           break;
   }


See Also :

IDCreateTable
----------------------------------------------------------------------------------------------------------