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
FltGetDestinationFileNameInformation
FltGetFileNameInformationUnsafe