Konstanta Atribut File

Atribut file adalah nilai metadata yang disimpan oleh sistem file pada disk dan digunakan oleh sistem dan tersedia untuk pengembang melalui berbagai API I/O file. Untuk daftar API dan topik terkait, lihat bagian Lihat juga .

Contoh

FILE_BASIC_INFO basicInfo;
    BOOL result;

    result = GetFileInformationByHandleEx( hFile,
                                               FileBasicInfo,
                                               &basicInfo,
                                               sizeof(basicInfo));

\\...

printf("  File Attributes: ");
    PrintFileAttributes(basicInfo.FileAttributes);

\\...
VOID
PrintFileAttributes(
    ULONG FileAttributes
    )
{
    
    if (FileAttributes & FILE_ATTRIBUTE_ARCHIVE) {
        printf("Archive ");
    }
    if (FileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
        printf("Directory ");
    }
    if (FileAttributes & FILE_ATTRIBUTE_READONLY) {
        printf("Read-Only ");
    }
}

Contoh yang diambil dari Sampel Klasik Windows di GitHub.

Konstanta/nilai Deskripsi
FILE_ATTRIBUTE_READONLY
1 (0x00000001)
File yang bersifat baca-saja. Aplikasi dapat membaca file, tetapi tidak dapat menulis atau menghapusnya. Atribut ini tidak dihormati pada direktori. Untuk informasi selengkapnya, lihat Anda tidak dapat melihat atau mengubah atribut Baca-saja atau Sistem folder di Windows Server 2003, di Windows XP, di Windows Vista atau di Windows 7.
FILE_ATTRIBUTE_HIDDEN
2 (0x00000002)
File atau direktori disembunyikan. Ini tidak termasuk dalam daftar direktori biasa.
FILE_ATTRIBUTE_SYSTEM
4 (0x00000004)
File atau direktori yang digunakan sistem operasi, atau digunakan secara eksklusif.
FILE_ATTRIBUTE_DIRECTORY
16 (0x00000010)
Handel yang mengidentifikasi direktori.
FILE_ATTRIBUTE_ARCHIVE
32 (0x00000020)
File atau direktori yang merupakan file arsip atau direktori. Aplikasi biasanya menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan.
FILE_ATTRIBUTE_DEVICE
64 (0x00000040)
Nilai ini dicadangkan untuk penggunaan sistem.
FILE_ATTRIBUTE_NORMAL
128 (0x00000080)
File yang tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid jika digunakan sendiri.
FILE_ATTRIBUTE_TEMPORARY
256 (0x00000100)
File yang sedang digunakan untuk penyimpanan sementara. Sistem file menghindari penulisan data kembali ke penyimpanan massal jika memori cache yang memadai tersedia, karena biasanya, aplikasi menghapus file sementara setelah handel ditutup. Dalam skenario itu, sistem sepenuhnya dapat menghindari penulisan data. Jika tidak, data ditulis setelah handel ditutup.
FILE_ATTRIBUTE_SPARSE_FILE
512 (0x00000200)
File yang merupakan file jarang.
FILE_ATTRIBUTE_REPARSE_POINT
1024 (0x00000400)
File atau direktori yang memiliki titik reparse terkait, atau file yang merupakan tautan simbolis.
FILE_ATTRIBUTE_COMPRESSED
2048 (0x00000800)
File atau direktori yang dikompresi. Untuk file, semua data dalam file dikompresi. Untuk direktori, kompresi adalah default untuk file dan subdirektori yang baru dibuat.
FILE_ATTRIBUTE_OFFLINE
4096 (0x00001000)
Data file tidak segera tersedia. Atribut ini menunjukkan bahwa data file dipindahkan secara fisik ke penyimpanan offline. Atribut ini digunakan oleh Penyimpanan Jarak Jauh, yang merupakan perangkat lunak manajemen penyimpanan hierarkis. Aplikasi tidak boleh secara segan-segan mengubah atribut ini.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
8192 (0x00002000)
File atau direktori tidak akan diindeks oleh layanan pengindeksan konten.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x00004000)
File atau direktori yang dienkripsi. Untuk file, semua aliran data dalam file dienkripsi. Untuk direktori, enkripsi adalah default untuk file dan subdirektori yang baru dibuat.
FILE_ATTRIBUTE_INTEGRITY_STREAM
32768 (0x00008000)
Aliran data direktori atau pengguna dikonfigurasi dengan integritas (hanya didukung pada volume ReFS). Ini tidak termasuk dalam daftar direktori biasa. Pengaturan integritas tetap ada pada file jika diganti namanya. Jika file disalin, file tujuan akan memiliki integritas yang diatur jika file sumber atau direktori tujuan memiliki integritas yang ditetapkan.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung hingga Windows Server 2012.
FILE_ATTRIBUTE_VIRTUAL
65536 (0x00010000)
Nilai ini dicadangkan untuk penggunaan sistem.
FILE_ATTRIBUTE_NO_SCRUB_DATA
131072 (0x00020000)
Aliran data pengguna tidak dibaca oleh pemindai integritas data latar belakang (AKA scrubber). Ketika diatur pada direktori, itu hanya memberikan pewarisan. Bendera ini hanya didukung pada Ruang Penyimpanan dan volume ReFS. Ini tidak termasuk dalam daftar direktori biasa.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Bendera ini tidak didukung sampai Windows 8 dan Windows Server 2012.
FILE_ATTRIBUTE_EA
262144 (0x00040000)
File atau direktori dengan atribut yang diperluas.

PENTING: Konstanta ini hanya untuk penggunaan internal.
FILE_ATTRIBUTE_PINNED
524288 (0x00080000)
Atribut ini menunjukkan niat pengguna bahwa file atau direktori harus tetap sepenuhnya ada secara lokal bahkan ketika tidak diakses secara aktif. Atribut ini untuk digunakan dengan perangkat lunak manajemen penyimpanan hierarkis.
FILE_ATTRIBUTE_UNPINNED
1048576 (0x00100000)
Atribut ini menunjukkan bahwa file atau direktori tidak boleh disimpan sepenuhnya hadir secara lokal kecuali saat diakses secara aktif. Atribut ini untuk digunakan dengan perangkat lunak manajemen penyimpanan hierarkis.
FILE_ATTRIBUTE_RECALL_ON_OPEN
262144 (0x00040000)
Atribut ini hanya muncul di kelas enumerasi direktori (FILE_DIRECTORY_INFORMATION, FILE_BOTH_DIR_INFORMATION, dll.). Ketika atribut ini diatur, itu berarti bahwa file atau direktori tidak memiliki representasi fisik pada sistem lokal; item adalah virtual. Membuka item akan lebih mahal dari biasanya, misalnya akan menyebabkan setidaknya beberapa item diambil dari penyimpanan jarak jauh.
FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS
4194304 (0x00400000)
Ketika atribut ini diatur, itu berarti bahwa file atau direktori tidak sepenuhnya ada secara lokal. Untuk file yang berarti bahwa tidak semua datanya ada di penyimpanan lokal (misalnya mungkin jarang dengan beberapa data yang masih dalam penyimpanan jarak jauh). Untuk direktori, itu berarti bahwa beberapa konten direktori sedang divirtualisasi dari lokasi lain. Membaca file / menghitung direktori akan lebih mahal dari biasanya, misalnya akan menyebabkan setidaknya beberapa konten file/direktori diambil dari penyimpanan jarak jauh. Hanya pemanggil mode kernel yang dapat mengatur bit ini.

Filter mini sistem file di bawah rentang ketinggian 180000 – 189999 (FSFilter HSM Load Order Group) tidak boleh mengeluarkan pembacaan cache yang ditargetkan atau menulis ke file yang memiliki set atribut ini. Ini dapat menyebabkan polusi cache dan potensi kerusakan file. Untuk informasi selengkapnya, lihat Menangani tempat penampung.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header WinNT.h (termasuk Windows.h)

Lihat juga

Atribut Pemadatan

Membuat dan Membuka File

CreateFile

CreateFileTransacted

GetFileAttributes

GetFileAttributesEx

GetFileAttributesTransacted

GetFileInformationByHandle

GetFileInformationByHandleEx

SetFileAttributes

SetFileAttributesTransacted

SetFileInformationByHandle