Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

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

Elements

FindExSearchNameMatch

File that matches the specified file name. The lpSearchFilterparameter of FindFirstFileExmust be set to NULL when this search operation is used.

FindExSearchLimitToDevices

Device names only are returned. The dwAdditionalFlagsparameter of FindFirstFileExcannot be set to FIND_FIRST_EX_CASE_SENSITIVE when this search operation is used.

FindExSearchLimitToDirectories

If the file system supports directory filtering, the function searches for a directory with the specified name. 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 lpSearchFilterparameter of FindFirstFileExmust be set to NULL. If you want directory filtering, use this flag on all file systems, but be sure to examine the file attribute data stored in the * lpFindFileDataparameter of FindFirstFileExto determine whether the function has indeed returned a handle to a directory.

When the FindExSearchLimitToDevicessearch 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

Header winbase.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also