FINDEX_SEARCH_OPS

  • Article

This enumeration defines values that are used with the FindFirstFileEx function to specify the type of filtering to perform.

typedef enum _FINDEX_SEARCH_OPS { 
  FindExSearchNameMatch, 
  FindExSearchLimitToDirectories, 
  FindExSearchLimitToDevices 
} FINDEX_SEARCH_OPS;

Elements

  • FindExSearchNameMatch
    File that matches the specified file name. Note that the lpSearchFilter parameter of FindFirstFileEx must be NULL when this search operation is used.
  • FindExSearchLimitToDevices
    Device names only will be returned. The dwAdditionalFlags parameter of FindFirstFileEx cannot be FIND_FIRST_EX_CASE_SENSITIVE when this search operation is used.
  • FindExSearchLimitToDirectories
    If the file system supports directory filtering, the function searches for a file that matches the specified file name and that is a directory. If the file system does not support directory filtering, this flag is silently ignored. This is an advisory flag.

Remarks

When the FindExSearchLimitToDirectories search operation is used, the lpSearchFilter parameter of FindFirstFileEx must be NULL. If you want directory filtering, use this flag on all file systems, but be sure to examine the file attribute data stored into the *lpFindFileData parameter of FindFirstFileEx to determine whether the function has indeed returned a handle to a directory.

When the FindExSearchLimitToDevices search operation is used, you can pass in a filter pattern, but either pass in no path, for example, L"c*" to get all devices starting with a c, or a rooted path, for example, L"\\c*".

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Winbase.h.

See Also

FindFirstFileEx

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.