The mmioCFFindEntry function enables you to find a particular entry in an open RIFF compound file. The mmioCFFindEntry function requires the pmmctocentry parameter which identifies a pointer to a user-supplied CTOC structure containing the name of the RIFF compound file element to search for. You can set flags in ulFlags to specify that an element is to be searched for by some attribute other than its name.
Flags for mmioCFFindEntry include the following.
┌──────────────────────────────┬──────────────────────────────┐ │Flag │Description │ ├──────────────────────────────┼──────────────────────────────┤ │MMIO_FINDFIRST │Finds the first entry in the │ │ │CTOC table. │ │ │Note: MMIO_FINDFIRST is │ │ │ignored if you set either │ │ │MMIO_FINDDELETED or │ │ │MMIO_FINDNEXT. │ ├──────────────────────────────┼──────────────────────────────┤ │MMIO_FINDNEXT │Finds the next entry in the │ │ │CTOC table after the entry │ │ │that contains the element │ │ │searched for. │ ├──────────────────────────────┼──────────────────────────────┤ │MMIO_FINDDELETED │Finds the first entry in the │ │ │table that has been marked as │ │ │"deleted", or the next deleted│ │ │entry following the entry that│ │ │contains the element to search│ │ │for. │ └──────────────────────────────┴──────────────────────────────┘
The search is case-insensitive. If no flags are set, the search is for the element only. If the function succeeds, the pmmctocentry buffer is filled with information about the CTOC entry. You can progress through the CTOC entry list by doing a FINDFIRST followed by a series of FINDNEXT, using the information from the previous function.