FLT_FILE_NAME_OPTIONS

發行項
03/14/2023

FLT_FILE_NAME_OPTIONS類型是 ULONG 值，指定檔案名資訊查詢的名稱格式、查詢方法和旗標。

typedef ULONG FLT_FILE_NAME_OPTIONS;
#define FLT_VALID_FILE_NAME_FORMATS                       0x000000ff
    #define FLT_FILE_NAME_NORMALIZED                      0x00000001
    #define FLT_FILE_NAME_OPENED                          0x00000002
    #define FLT_FILE_NAME_SHORT                           0x00000003
#define FLT_VALID_FILE_NAME_QUERY_METHODS                 0x0000ff00
    #define FLT_FILE_NAME_QUERY_DEFAULT                   0x00000100
    #define FLT_FILE_NAME_QUERY_CACHE_ONLY                0x00000200
    #define FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY           0x00000300
    #define FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP 0x00000400
#define FLT_VALID_FILE_NAME_FLAGS                         0xff000000
    #define FLT_FILE_NAME_REQUEST_FROM_CURRENT_PROVIDER   0x01000000
    #define FLT_FILE_NAME_DO_NOT_CACHE                    0x02000000
    #define FLT_FILE_NAME_ALLOW_QUERY_ON_REPARSE          0x04000000

位 0 到 7 表示可以使用 FltGetFileNameFormat 宏查詢的檔案格式。如需這些格式的說明，請參閱 FLT_FILE_NAME_INFORMATION。目前已定義下列值。

值	意義
FLT_FILE_NAME_NORMALIZED	檔案的標準化名稱。
FLT_FILE_NAME_OPENED	開啟此檔案控制碼時所使用的名稱。此名稱未正規化。
FLT_FILE_NAME_SHORT	檔案的簡短 (8.3) 名稱。檔案的簡短名稱不包含磁片區名稱、目錄路徑或資料流程名稱。此名稱未正規化。

位 8 到 15 指定篩選管理員要使用的檔案名查詢方法，您可以使用 FltGetFileNameQueryMethod 宏來查詢。如需這些值的說明，請參閱 FltGetFileNameInformation。目前已定義下列值。

值	意義
FLT_FILE_NAME_QUERY_DEFAULT	如果目前無法安全地查詢檔案系統的檔案名，則不執行任何動作。否則，請查詢篩選管理員的名稱快取以取得檔案名資訊。如果在快取中找不到名稱，請查詢檔案系統並快取結果。
FLT_FILE_NAME_QUERY_CACHE_ONLY	查詢篩選管理員的名稱快取以取得檔案名資訊。請勿查詢檔案系統。
FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY	查詢檔案系統中的檔案名資訊。請勿查詢篩選管理員的名稱快取，也不會快取檔案系統查詢的結果。
FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP	查詢篩選管理員的名稱快取以取得檔案名資訊。如果在快取中找不到名稱，且目前安全這麼做，請查詢檔案系統中的檔案名資訊並快取結果。

目前未使用位 16 到 23。

名稱提供者迷你篩選會使用位 24 到 31 來指定檔案名旗標。目前已定義下列值。

值	意義
FLT_FILE_NAME_REQUEST_FROM_CURRENT_PROVIDER	名稱提供者迷你篩選器可以使用這個旗標來指出名稱查詢要求應該重新導向至本身，而不是由堆疊中較低的名稱提供者篩選準則滿足。
FLT_FILE_NAME_DO_NOT_CACHE	此旗標表示不應該快取從此查詢擷取的名稱。名稱提供者迷你篩選會使用此旗標來執行中繼查詢來產生名稱。
FLT_FILE_NAME_ALLOW_QUERY_ON_REPARSE	名稱提供者迷你篩選工具可以使用這個旗標來指定即使傳回STATUS_REPARSE，在建立後路徑中查詢名稱是安全的。呼叫者必須負責確保 FileObject-FileName > 欄位未變更。請勿將此旗標與掛接點或符號連結重新剖析點搭配使用。