Bagikan melalui

enumerasi KNOWN_FOLDER_FLAG (shlobj_core.h)

  • Artikel

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)

Lihat juga