Bagikan melalui


Folder yang Diketahui

Windows Vista memperkenalkan skenario penyimpanan baru dan namespace profil pengguna baru. Untuk mengatasi faktor-faktor baru ini, sistem lama yang merujuk ke folder standar oleh nilai CSIDL telah diganti. Pada Windows Vista, folder tersebut dirujuk oleh sekumpulan nilai GUID baru yang disebut ID Folder yang Diketahui.

Sistem Folder yang Diketahui memberikan keuntungan berikut:

  • Vendor perangkat lunak independen (ISV) dapat memperluas serangkaian ID Folder yang Diketahui dengan ID mereka sendiri. Mereka dapat menentukan folder, memberi mereka ID, dan mendaftarkannya dengan sistem. Nilai CSIDL tidak dapat diperluas.
  • Semua Folder yang Diketahui pada sistem dapat dijumlahkan. Tidak ada API yang menyediakan fungsionalitas ini untuk nilai CSIDL. Lihat IKnownFolderManager::GetFolderIds untuk informasi selengkapnya.
  • Folder yang diketahui ditambahkan oleh ISV dapat menambahkan properti kustom yang memungkinkannya menjelaskan tujuan dan penggunaan yang dimaksudkan.
  • Banyak folder yang diketahui dapat dialihkan ke lokasi baru, termasuk lokasi jaringan. Di bawah sistem CSIDL, hanya folder Dokumen Saya yang dapat dialihkan.
  • Folder yang diketahui dapat memiliki handler kustom untuk digunakan selama pembuatan atau penghapusan.

Sistem CSIDL dan API yang menggunakan nilai CSIDL masih didukung untuk kompatibilitas. Namun, tidak disarankan untuk menggunakannya dalam pengembangan baru apa pun.

Topik berikut membahas spesifikasi sistem Folder yang Diketahui.

Halaman referensi berikut menjelaskan fungsi Folder Yang Diketahui Win32, yang dapat digunakan untuk mengambil lokasi Folder yang Diketahui atau mengalihkannya ke lokasi baru. Fungsi-fungsi ini menggantikan fungsi Win32 yang lebih lama. Fungsi baru disediakan untuk memberikan perilaku yang setara dengan fungsi lama, tetapi setiap fungsi baru juga diduplikasi oleh API Model Objek Komponen (COM).

Fungsi baru Menggantikan Setara COM
SHGetKnownFolderPath SHGetFolderPath IKnownFolder::GetPath
SHGetKnownFolderIDList SHGetFolderLocation IKnownFolder::GetIDList
SHSetKnownFolderPath SHSetFolderPath IKnownFolder::SetPath

 

Halaman referensi berikut menjelaskan COM Known Folders API, yang menyediakan semua fungsionalitas API Win32 yang tercantum di atas, ditambah menambahkan kemampuan untuk menghitung semua Folder yang Diketahui, mengakses properti Folder yang Diketahui, dan memperluas kumpulan standar Folder yang Diketahui.

Sampel C++ yang menunjukkan API Folder yang Diketahui disertakan dalam Kit Pengembangan Perangkat Lunak (SDK) Windows. Setelah Anda menginstal Windows SDK di komputer Anda, sampel dapat ditemukan di bawah %ProgramFiles%\Microsoft SDKs\Windows\v6.0\Samples\WinUI\Shell\AppPlatform\KnownFolders.

Sampel Folder yang Diketahui