Bekerja dengan Folder yang Diketahui dalam Aplikasi

  • Artikel

Sistem Folder Yang Diketahui menyediakan cara untuk berinteraksi dengan folder profil tinggi tertentu yang ada secara default di Windows. Ini juga memungkinkan interaksi yang sama dengan folder yang diinstal dan terdaftar dengan sistem Folder Yang Diketahui oleh aplikasi. Topik ini membahas kemungkinan interaksi tersebut saat disediakan oleh API Folder yang Diketahui.

Penting

Untuk mengalihkan folder Dokumen, Gambar, atau Desktop ke OneDrive, gunakan OneDrive Known Folder Move alih-alih metode pengalihan yang dijelaskan dalam artikel ini. Untuk informasi, lihat Mengalihkan dan memindahkan folder yang diketahui Windows ke OneDrive.

Antarmuka Folder yang Diketahui

Ada dua antarmuka Folder yang Diketahui: IKnownFolder dan IKnownFolderManager.

IKnownFolderManager menyediakan banyak fungsi yang lebih umum sehubungan dengan folder ini. Metodenya memungkinkan Anda untuk:

  • Ambil IKnownFolder berdasarkan KNOWNFOLDERID folder tersebut, nama kanonisnya, jalurnya yang dinyatakan sebagai string, atau jalurnya yang dinyatakan sebagai IDList.
  • Konversikan CSIDL ke KNOWNFOLDERID setara atau konversi KNOWNFOLDERID ke CSIDL warisannya yang setara.
  • Daftarkan atau batalkan pendaftaran Folder yang Diketahui dengan sistem.
  • Ambil semua nilai KNOWNFOLDERID yang terdaftar pada sistem tersebut.
  • Alihkan Folder yang Diketahui ke lokasi baru.

IKnownFolder menyediakan metode yang memungkinkan folder untuk mengalihkan dirinya dengan menyediakan jalur baru. Metode lain mendapatkan informasi tentang Folder yang Diketahui tertentu, termasuk:

  • Kategori folder: virtual, tetap, umum, atau per pengguna.
  • Tipe folder, seperti terkompresi, dokumen, gambar, atau file pengguna.
  • KNOWNFOLDERID dari folder.
  • Jalur lengkap folder sebagai IDList atau sebagai string. Juga jalur relatifnya ke folder induk.
  • Nama kanonis folder.
  • Tipsalat ditampilkan untuk folder.
  • Ikon ditampilkan untuk folder.
  • Deskripsi folder yang menjelaskan tujuan dan penggunaannya.
  • Apakah folder mampu dialihkan.

IKnownFolder juga menyediakan metode untuk mengambil IShellItem berdasarkan folder . Itu memungkinkan Anda untuk mengikat folder ke handler, membandingkan dua folder, dan mengambil atribut folder, nama tampilan, dan folder induk.

Pengalihan

Pengalihan folder adalah fitur penting dari sistem folder yang diketahui. Semua folder kategori yang diketahui umumKF_CATEGORY_COMMON**** atau per penggunaKF_CATEGORY_PERUSER**** dapat dialihkan. Folder kategori KF_CATEGORY_VIRTUAL virtual**** atau fixedrKF_CATEGORY_FIXED****, namun, tidak dapat dialihkan.

Folder dapat diarahkan ke lokasi lain pada komputer yang sama atau ke lokasi pada jaringan. Dalam kasus pengalihan jaringan, folder dapat di-cache secara lokal melalui penembolokan sisi klien untuk menyediakan akses offline. Namun, bahkan jika cache lokal ada, folder yang dialihkan itu sendiri harus diakses melalui jaringan.

Pengalihan folder bukan hal baru untuk Windows Vista. Misalnya, di Windows XP beberapa folder yang diidentifikasi melalui sistem CSIDL dapat dialihkan melalui panggilan ke SHSetFolderPath atau dengan memodifikasi entri CSIDL di registri. Di Windows Vista dan yang lebih baru, pengalihan harus dilakukan melalui IKnownFolder::SetPath atau SHSetKnownFolderPath.

Untuk menentukan apakah folder dapat dialihkan, panggil IKnownFolder::GetRedirectionCapabilities. Jika folder tidak dapat dialihkan, panggilan ini dapat memberikan penjelasan.

Jika folder dialihkan ke lokasi jaringan, metode IKnownFolder masih dapat berhasil dipanggil di dalamnya.

Sampel Folder yang Diketahui