Share via


FINDEX_SEARCH_OPS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This enumeration defines values that are used with the FindFirstFileEx function 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 lpSearchFilter parameter of FindFirstFileEx must be set to NULL when this search operation is used.
  • FindExSearchLimitToDevices
    Device names only are returned. The dwAdditionalFlags parameter of FindFirstFileEx cannot 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 lpSearchFilter parameter of FindFirstFileEx must 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 *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

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

See Also

Reference

File I/O Enumerations
FindFirstFileEx