FLT_FILE_NAME_OPTIONS

Artikel
03/14/2023

Jenis FLT_FILE_NAME_OPTIONS adalah nilai ULONG yang menentukan format nama, metode kueri, dan bendera untuk kueri informasi nama file.

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

Bit 0 sampai 7 menunjukkan format file, yang dapat dikueri dengan menggunakan makro FltGetFileNameFormat . Untuk penjelasan tentang format ini, lihat FLT_FILE_NAME_INFORMATION. Nilai berikut saat ini ditentukan.

Nilai	Makna
FLT_FILE_NAME_NORMALIZED	Nama yang dinormalisasi untuk file.
FLT_FILE_NAME_OPENED	Nama yang digunakan ketika handel dibuka ke file ini. Nama ini tidak dinormalisasi.
FLT_FILE_NAME_SHORT	Nama pendek (8.3) untuk file. Nama pendek untuk file tidak menyertakan nama volume, jalur direktori, atau nama aliran. Nama ini tidak dinormalisasi.

Bit 8 hingga 15 menentukan metode kueri nama file yang akan digunakan oleh Manajer Filter, yang dapat dikueri dengan menggunakan makro FltGetFileNameQueryMethod . Untuk penjelasan tentang nilai-nilai ini, lihat FltGetFileNameInformation. Nilai berikut saat ini ditentukan.

Nilai	Makna
FLT_FILE_NAME_QUERY_DEFAULT	Jika saat ini tidak aman untuk mengkueri sistem file untuk nama file, jangan lakukan apa pun. Jika tidak, kueri cache nama Manajer Filter untuk informasi nama file. Jika nama tidak ditemukan di cache, kueri sistem file dan cache hasilnya.
FLT_FILE_NAME_QUERY_CACHE_ONLY	Kueri cache nama Manajer Filter untuk informasi nama file. Jangan mengkueri sistem file.
FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY	Mengkueri sistem file untuk informasi nama file. Jangan mengkueri cache nama Manajer Filter, dan jangan menyimpan cache hasil kueri sistem file.
FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP	Kueri cache nama Manajer Filter untuk informasi nama file. Jika nama tidak ditemukan di cache dan saat ini aman untuk melakukannya, kueri sistem file untuk informasi nama file dan cache hasilnya.

Bit 16 hingga 23 saat ini tidak digunakan.

Bit 24 hingga 31 digunakan oleh minifilter penyedia nama untuk menentukan bendera nama file. Nilai berikut saat ini ditentukan.

Nilai	Makna
FLT_FILE_NAME_REQUEST_FROM_CURRENT_PROVIDER	Minifilter penyedia nama dapat menggunakan bendera ini untuk Menunjukkan bahwa permintaan kueri nama harus dialihkan ke dirinya sendiri daripada dipenuhi oleh filter penyedia nama yang lebih rendah di tumpukan.
FLT_FILE_NAME_DO_NOT_CACHE	Bendera ini menunjukkan bahwa nama yang diambil dari kueri ini tidak boleh di-cache. Minifilter penyedia nama menggunakan bendera ini saat mereka melakukan kueri perantara untuk menghasilkan nama.
FLT_FILE_NAME_ALLOW_QUERY_ON_REPARSE	Minifilter penyedia nama dapat menggunakan bendera ini untuk menentukan bahwa aman untuk mengkueri nama di jalur pasca-buat meskipun STATUS_REPARSE dikembalikan. Pemanggil bertanggung jawab untuk memastikan bahwa bidang FileObject-FileName> tidak diubah. Jangan gunakan bendera ini dengan titik pemasangan atau titik pemilah ulang tautan simbolis.