FltGetFileNameQueryMethod macro

Artigo
08/03/2017

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

Compartilhar via