FltGetFileNameQueryMethod macro

The FltGetFileNameQueryMethod macro returns the name query method portion of an FLT_FILE_NAME_OPTIONS value.

Syntax

ULONG FltGetFileNameQueryMethod(
  [in] FLT_FILE_NAME_OPTIONS NameOptions
);

Parameters

  • NameOptions [in]
    FLT_FILE_NAME_OPTIONS value used to specify the name format, query method, and flags for a file name information query.

Return value

The FltGetFileNameQueryMethod macro returns the name query method portion of the FLT_FILE_NAME_OPTIONS value that the NameOptions parameter specifies.

Remarks

The FltGetFileNameQueryMethod macro returns one of the values listed in the following table.

Value Meaning

FLT_FILE_NAME_QUERY_DEFAULT

If it is not currently safe to query the file system for the file name, do nothing. Otherwise, query the Filter Manager's name cache for the file name information. If the name is not found in the cache, query the file system and cache the result.

FLT_FILE_NAME_QUERY_CACHE_ONLY

Query the Filter Manager's name cache for the file name information. Do not query the file system.

FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY

Query the file system for the file name information. Do not query the Filter Manager's name cache, and do not cache the result of the file system query.

FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP

Query the Filter Manager's name cache for the file name information. If the name is not found in the cache, and it is currently safe to do so, query the file system for the file name information and cache the result.

 

For more information about these values, see FltGetFileNameInformation.

Requirements

Target platform

Desktop

Header

Fltkernel.h (include Fltkernel.h)

IRQL

Any

See also

FLT_FILE_NAME_INFORMATION

FLT_FILE_NAME_OPTIONS

FltGetDestinationFileNameInformation

FltGetFileNameFormat

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

 

 

Send comments about this topic to Microsoft