enumerasi KNOWN_FOLDER_FLAG (shlobj_core.h)
Menentukan konstanta yang menentukan opsi pengambilan khusus untuk folder yang diketahui (misalnya, untuk digunakan saat memanggil fungsi SHGetKnownFolderIDList untuk mengambil jalur folder yang diketahui). Nilai-nilai ini menggantikan nilai CSIDL , yang memiliki arti paralel.
Sintaks
typedef enum {
KF_FLAG_DEFAULT = 0x00000000,
KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000,
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000,
KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000,
KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000,
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000,
KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000,
KF_FLAG_CREATE = 0x00008000,
KF_FLAG_DONT_VERIFY = 0x00004000,
KF_FLAG_DONT_UNEXPAND = 0x00002000,
KF_FLAG_NO_ALIAS = 0x00001000,
KF_FLAG_INIT = 0x00000800,
KF_FLAG_DEFAULT_PATH = 0x00000400,
KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200,
KF_FLAG_SIMPLE_IDLIST = 0x00000100,
KF_FLAG_ALIAS_ONLY = 0x80000000
} KNOWN_FOLDER_FLAG;
Konstanta
KF_FLAG_DEFAULT Nilai: 0x00000000 Menentukan tidak ada opsi pengambilan khusus. |
KF_FLAG_FORCE_APP_DATA_REDIRECTION Nilai: 0x00080000 Diperkenalkan dalam Windows 10, versi 1709. Ketika dipanggil dari aplikasi paket, menentukan bahwa folder LocalAppData/RoamingAppData dialihkan ke lokasi aplikasi privat yang cocok dengan jalur yang dikembalikan dari properti Windows.Storage.ApplicationData.Current di LocalFolder dan RoamingFolder . Folder lain dialihkan ke subdirektori LocalAppData. Bendera ini digunakan dengan FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites, dan FOLDERID_AppDataProgramData. Ini juga ditujukan untuk kompatibilitas dengan aplikasi .NET, dan tidak dimaksudkan untuk digunakan langsung dari aplikasi. |
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET Nilai: 0x00040000 Diperkenalkan dalam Windows 10, versi 1703. Saat berjalan dalam proses paket, menentukan bahwa beberapa lokasi sistem file dialihkan ke lokasi khusus paket oleh sistem file. Bendera ini menyebabkan target arah dikembalikan untuk lokasi tersebut. Ini berguna dalam kasus di mana lokasi nyata dalam sistem file perlu diketahui. |
KF_FLAG_FORCE_PACKAGE_REDIRECTION Nilai: 0x00020000 Diperkenalkan dalam Windows 10, versi 1703. Saat berjalan di dalam proses AppContainer, atau saat memberikan token AppContainer, menentukan bahwa beberapa folder dialihkan ke lokasi khusus AppContainer dalam paket. Bendera ini memaksa pengalihan (untuk folder yang biasanya tidak dialihkan) untuk keperluan proses yang dipaketkan, dan dapat digunakan untuk berbagi file antara UWP dan aplikasi paket dalam paket yang sama. Bendera ini menggantikan KF_FLAG_FORCE_APPCONTAINER_REDIRECTION yang tidak digunakan lagi. |
KF_FLAG_NO_PACKAGE_REDIRECTION Nilai: 0x00010000 Diperkenalkan dalam Windows 10, versi 1703. Saat berjalan di dalam proses yang dikemas, atau saat menyediakan token proses yang dikemas, menentukan bahwa beberapa folder dialihkan ke lokasi khusus paket. Bendera ini menonaktifkan pengalihan pada lokasi tempat bendera diterapkan, dan sebaliknya mengembalikan jalur yang akan dikembalikan jika tidak berjalan di dalam proses paket. Bendera ini menggantikan KF_FLAG_NO_APPCONTAINER_REDIRECTION yang tidak digunakan lagi. |
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION Nilai: 0x00020000 Diperkenalkan dalam Windows 8. Bendera ini tidak digunakan lagi dalam Windows 10, versi 1703. Gunakan KF_FLAG_FORCE_PACKAGE_REDIRECTION sebagai gantinya. |
KF_FLAG_NO_APPCONTAINER_REDIRECTION Nilai: 0x00010000 Diperkenalkan dalam Windows 8. Bendera ini tidak digunakan lagi dalam Windows 10, versi 1703. Gunakan KF_FLAG_NO_PACKAGE_REDIRECTION sebagai gantinya. |
KF_FLAG_CREATE Nilai: 0x00008000 Menentukan untuk memaksa pembuatan folder yang ditentukan jika folder tersebut belum ada. Ketentuan keamanan yang telah ditentukan sebelumnya untuk folder tersebut diterapkan. Jika folder tidak ada dan tidak dapat dibuat, maka fungsi mengembalikan kode kegagalan, dan tidak ada jalur yang dikembalikan. Nilai ini hanya dapat digunakan dengan fungsi dan metode berikut: * SHGetKnownFolderPath * SHGetKnownFolderIDList * IKnownFolder::GetIDList * IKnownFolder::GetPath * IKnownFolder::GetShellItem |
KF_FLAG_DONT_VERIFY Nilai: 0x00004000 Menentukan untuk tidak memverifikasi keberadaan folder sebelum mencoba mengambil jalur atau IDList. Jika bendera ini tidak diatur, maka upaya dilakukan untuk memverifikasi bahwa folder benar-benar ada di jalur. Jika verifikasi tersebut gagal karena folder tidak ada atau tidak dapat diakses, maka fungsi mengembalikan kode kegagalan, dan tidak ada jalur yang dikembalikan. Jika folder terletak di jaringan, maka fungsi mungkin membutuhkan waktu lebih lama untuk dijalankan. Jadi mengatur bendera ini dapat mengurangi latensi tersebut. |
KF_FLAG_DONT_UNEXPAND Nilai: 0x00002000 Spesifikasi untuk menyimpan jalur lengkap di registri tanpa menggunakan string lingkungan. Jika bendera ini tidak diatur, maka bagian jalur mungkin diwakili oleh string lingkungan seperti %USERPROFILE% . Bendera ini hanya dapat digunakan dengan SHSetKnownFolderPath dan IKnownFolder::SetPath. |
KF_FLAG_NO_ALIAS Nilai: 0x00001000 Menentukan untuk mengambil jalur sistem yang benar untuk folder, bebas dari tempat penampung alias seperti %USERPROFILE% , yang dikembalikan oleh SHGetKnownFolderIDList dan IKnownFolder::GetIDList. Bendera ini tidak berpengaruh pada jalur yang dikembalikan oleh SHGetKnownFolderPath dan IKnownFolder::GetPath. Secara default, fungsi dan metode pengambilan folder yang diketahui mengembalikan jalur alias jika ada alias. |
KF_FLAG_INIT Nilai: 0x00000800 Menentukan untuk menginisialisasi folder menggunakan pengaturannya Desktop.ini . Jika folder tidak dapat diinisialisasi, maka fungsi mengembalikan kode kegagalan, dan tidak ada jalur yang dikembalikan. Bendera ini harus selalu digabungkan dengan KF_FLAG_CREATE.Jika folder terletak di jaringan, maka fungsi mungkin membutuhkan waktu lebih lama untuk dijalankan. |
KF_FLAG_DEFAULT_PATH Nilai: 0x00000400 Menentukan untuk mengambil jalur default untuk folder yang diketahui. Jika bendera ini tidak diatur, maka fungsi mengambil saat ini—dan mungkin dialihkan—jalur folder. Eksekusi bendera ini mencakup verifikasi keberadaan folder kecuali KF_FLAG_DONT_VERIFY diatur. |
KF_FLAG_NOT_PARENT_RELATIVE Nilai: 0x00000200 Menentukan untuk mengambil jalur default folder yang independen dari lokasi induknya saat ini. KF_FLAG_DEFAULT_PATH juga harus diatur. |
KF_FLAG_SIMPLE_IDLIST Nilai: 0x00000100 Menentukan untuk membangun IDList sederhana (PIDL). Nilai ini dapat digunakan ketika Anda ingin mengambil jalur sistem file. Tetapi jangan tentukan nilai ini jika Anda mengambil nama tampilan folder yang dilokalkan, karena mungkin tidak diselesaikan dengan benar. |
KF_FLAG_ALIAS_ONLY Nilai: 0x80000000 Diperkenalkan di Windows 7. Menentukan untuk hanya mengambil PIDL alias. Jangan gunakan jalur sistem file. |
Keterangan
Nilai-nilai ini, dengan pengecualian KF_FLAG_ALIAS_ONLY, didefinisikan dalam Windows Vista sebagai konstanta individual. Mereka didefinisikan sebagai enumerasi hanya di Windows 7 dan yang lebih baru. Namun, semua nilai numerik yang mendasar sama dalam salah satu bentuk.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Header | shlobj_core.h (termasuk Shlobj.h) |