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.

ValueMeaning

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

Show: