FINDEX_SEARCH_OPS

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

typedef enum _FINDEX_INFO_LEVELS { 
    FindExSearchNameMatch, 
    FindExSearchLimitToDirectories, 
    FindExSearchLimitToDevices, 
} FINDEX_INFO_LEVELS ;

Enumerator Value	Meaning
FindExSearchNameMatch	Search for a file that matches the specified filename. Note that lpSearchFilter parameter of FindFirstFileEx must be NULL when this search operation is used.
FindExSearchLimitToDevices	Only device names are returned. Device names are generally accessible through the \\.\<name> convention. The dwAdditionalFlags parameter of FindFirstFileEx cannot be FIND_FIRST_EX_CASE_SENSITIVE when this search operation is used.
FindExSearchLimitToDirectories	This is an advisory flag. If the file system supports directory filtering, the function searches for a "file" that matches the specified filename and that is a directory. If the file system does not support directory filtering, this flag is silently ignored. The lpSearchFilter parameter of FindFirstFileEx must be NULL when this search operation is used. 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.

Enumerator Value

Meaning

FindExSearchNameMatch

Search for a file that matches the specified filename. Note that lpSearchFilter parameter of FindFirstFileEx must be NULL when this search operation is used.

FindExSearchLimitToDevices

Only device names are returned. Device names are generally accessible through the \\.\<name> convention. The dwAdditionalFlags parameter of FindFirstFileEx cannot be FIND_FIRST_EX_CASE_SENSITIVE when this search operation is used.

FindExSearchLimitToDirectories

This is an advisory flag.

If the file system supports directory filtering, the function searches for a "file" that matches the specified filename and that is a directory.

If the file system does not support directory filtering, this flag is silently ignored.

The lpSearchFilter parameter of FindFirstFileEx must be NULL when this search operation is used.

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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winbase.h.

FINDEX_SEARCH_OPS

QuickInfo

See Also