Fungsi SetFileAttributesFromAppW (fileapifromapp.h)
Mengatur atribut untuk file atau direktori. Perilaku fungsi ini identik dengan SetFileAttributes, kecuali bahwa fungsi ini mematuhi model keamanan aplikasi Platform Windows Universal.
Sintaks
WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
LPCWSTR lpFileName,
DWORD dwFileAttributes
) noexcept;
Parameter
lpFileName
Nama file yang atributnya akan diatur.
Untuk informasi tentang menolak batasan MAX_PATH tanpa menambahkan "\\?\", lihat bagian "Batasan Panjang Jalur Maksimum" dari Penamaan File, Jalur, dan Namespace untuk detailnya.
dwFileAttributes
Atribut file yang akan diatur untuk file.
Parameter ini bisa menjadi satu atau beberapa nilai, dikombinasikan menggunakan operator bitwise-OR. Namun, semua nilai lainnya mengambil alih FILE_ATTRIBUTE_NORMAL.
Tidak semua atribut didukung oleh fungsi ini.
Berikut ini adalah daftar nilai atribut yang didukung.
Nilai | Makna |
---|---|
FILE_ATTRIBUTE_ARCHIVE 32 (0x20) | File atau direktori yang merupakan file arsip atau direktori. Aplikasi biasanya menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan. |
FILE_ATTRIBUTE_HIDDEN 2 (0x2) | File atau direktori disembunyikan. Ini tidak termasuk dalam daftar direktori biasa. |
FILE_ATTRIBUTE_NORMAL 128 (0x80) | File yang tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid jika digunakan sendiri. |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000) | File atau direktori tidak akan diindeks oleh layanan pengindeksan konten. |
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000) | 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 mengubah atribut ini. |
FILE_ATTRIBUTE_READONLY 1 (0x1) | File yang bersifat baca-saja. Aplikasi dapat membaca file, tetapi tidak dapat menulis atau menghapusnya. Atribut ini tidak dihormati pada direktori. |
FILE_ATTRIBUTE_SYSTEM 4 (0x4) | File atau direktori yang digunakan sistem operasi, atau digunakan secara eksklusif. |
FILE_ATTRIBUTE_TEMPORARY 256 (0x100) | 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. |
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Persyaratan
Klien minimum yang didukung | Windows 10, versi 1803 |
Header | fileapifromapp.h |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk