The search is not case-sensitive; the flags operate as follows:

• MMIO_FINDFIRST and MMIO_FINDNEXT cannot be specified together.

If an element is specified, it is ignored; if no element is specified, the flags operate as follows:

• If MMIO_FINDFIRST is specified, the first non-deleted entry is returned. 
  If MMIO_FINDFIRST and MMIO_FINDDELETED are specified, the first deleted element is returned.

  All other cases use the element name in the search, and the flags operate as follows:

  • If no flags are specified, the first non-deleted entry that matches the element name passed in is returned. 
    If MMIO_FINDNEXT is specified, the entry that matches the element name passed in is found. The first non-deleted entry following this entry is returned.
    
    If MMIO_FINDDELETED is specified, the entry that matches the element name passed in is found. If the entry is marked deleted, it is returned.
    
    If MMIO_FINDNEXT and MMIO_FINDDELETED are specified, the entry that matches the element name passed in is found. The element name passed in may refer to an existing or deleted entry. At this point, the next entry that is deleted is returned.

    If the function succeeds, the MMCTOCENTRY structure passed in the pmmctocentry parameter is filled in with information about the CTOC entry. The user can proceed through the CTOC entry list by using MMIO_FINDFIRST followed by a series of MMIO_FINDNEXT actions, using the information from the previous call.

    ---

    [Back] [Next]