Fungsi SetFileAttributesFromAppW (fileapifromapp.h)

Artikel
03/09/2023

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

Bagikan melalui