CSIDL
Catatan
Pada Windows Vista, nilai-nilai ini telah digantikan oleh nilai KNOWNFOLDERID . Lihat topik tersebut untuk daftar konstanta baru dan nilai CSIDL terkait. Untuk kenyamanan, nilai KNOWNFOLDERID yang sesuai juga dicatat di sini untuk setiap nilai CSIDL.
Sistem CSIDL didukung di bawah Windows Vista karena alasan kompatibilitas. Namun, pengembangan baru harus menggunakan nilai KNOWNFOLDERID daripada nilai CSIDL.
Nilai CSIDL (daftar ID item khusus konstan) menyediakan cara independen sistem yang unik untuk mengidentifikasi folder khusus yang sering digunakan oleh aplikasi, tetapi yang mungkin tidak memiliki nama atau lokasi yang sama pada sistem tertentu. Misalnya, folder sistem mungkin "C:\Windows" pada satu sistem dan "C:\Winnt" di sistem lain. Konstanta ini didefinisikan dalam Shlobj.h.
| Konstanta/nilai | Deskripsi |
|---|---|
|
Versi 5.0. Direktori sistem file yang digunakan untuk menyimpan alat administratif untuk pengguna individual. MMC akan menyimpan konsol yang disesuaikan ke direktori ini, dan akan menjelajah dengan pengguna. |
|
Direktori sistem file yang sesuai dengan grup program Startup nonlokalisasi pengguna. Nilai ini dikenali di Windows Vista untuk kompatibilitas mundur, tetapi folder itu sendiri tidak ada lagi. |
|
Versi 4.71. Direktori sistem file yang berfungsi sebagai repositori umum untuk data khusus aplikasi. Jalur umumnya adalah C:\Documents and Settings\username\Application Data. |
|
Folder virtual yang berisi objek di Keranjang Sampah pengguna. |
|
Versi 6.0. Direktori sistem file yang bertindak sebagai area penahapan untuk file yang menunggu ditulis ke CD. Jalur umumnya adalah C:\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD Burning. |
|
Versi 5.0. Direktori sistem file yang berisi alat administratif untuk semua pengguna komputer. |
|
Direktori sistem file yang sesuai dengan grup program Startup nonlokalisasi untuk semua pengguna. Nilai ini dikenali di Windows Vista untuk kompatibilitas mundur, tetapi folder itu sendiri tidak ada lagi. |
|
Versi 5.0. Direktori sistem file yang berisi data aplikasi untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Application Data. Folder ini digunakan untuk data aplikasi yang tidak spesifik untuk pengguna. Misalnya, aplikasi dapat menyimpan kamus pemeriksaan ejaan, database clip art, atau file log di folder CSIDL_COMMON_APPDATA. Informasi ini tidak akan berkeliaran dan tersedia bagi siapa pun yang menggunakan komputer. |
|
Direktori sistem file yang berisi file dan folder yang muncul di desktop untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Desktop. |
|
Direktori sistem file yang berisi dokumen yang umum untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Documents. |
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk item favorit yang umum untuk semua pengguna. |
|
Versi 6.0. Direktori sistem file yang berfungsi sebagai repositori untuk file musik yang umum untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Documents\My Music. |
|
Nilai ini dikenali di Windows Vista untuk kompatibilitas mundur, tetapi folder itu sendiri tidak lagi digunakan. |
|
Versi 6.0. Direktori sistem file yang berfungsi sebagai repositori untuk file gambar yang umum untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Documents\My Pictures. |
|
Direktori sistem file yang berisi direktori untuk grup program umum yang muncul di menu Mulai untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Start Menu\Programs. |
|
Direktori sistem file yang berisi program dan folder yang muncul pada menu Mulai untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Start Menu. |
|
Direktori sistem file yang berisi program yang muncul di folder Startup untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Start Menu\Programs\Startup. |
|
Direktori sistem file yang berisi templat yang tersedia untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Templates. |
|
Versi 6.0. Direktori sistem file yang berfungsi sebagai repositori untuk file video yang umum untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Documents\My Videos. |
|
Folder yang mewakili komputer lain dalam grup kerja Anda. |
|
Folder virtual yang mewakili Sambungan Jaringan, yang berisi sambungan jaringan dan putar-nomor. |
|
Folder virtual yang berisi ikon untuk aplikasi Panel Kontrol. |
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk cookie Internet. Jalur umumnya adalah C:\Documents and Settings\username\Cookies. |
|
Folder virtual yang mewakili desktop Windows, akar namespace layanan. |
|
Direktori sistem file yang digunakan untuk menyimpan objek file secara fisik di desktop (tidak bingung dengan folder desktop itu sendiri). Jalur umumnya adalah C:\Documents and Settings\username\Desktop. |
|
Folder virtual yang mewakili Komputer Saya, berisi semua yang ada di komputer lokal: perangkat penyimpanan, printer, dan Panel Kontrol. Folder juga dapat berisi drive jaringan yang dipetakan. |
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk item favorit pengguna. Jalur umumnya adalah C:\Documents and Settings\username\Favorites. |
|
Folder virtual yang berisi font. Jalur umumnya adalah C:\Windows\Fonts. |
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk item riwayat Internet. |
|
Folder virtual untuk Internet Explorer. |
|
Versi 4.72. Direktori sistem file yang berfungsi sebagai repositori umum untuk file Internet sementara. Jalur umumnya adalah C:\Documents and Settings\username\Local Settings\Temporary Internet Files. |
|
Versi 5.0. Direktori sistem file yang berfungsi sebagai repositori data untuk aplikasi lokal (nonroaming). Jalur umumnya adalah C:\Documents and Settings\username\Local Settings\Application Data. |
|
Versi 6.0. Folder virtual yang mewakili item desktop Dokumen Saya. Nilai ini setara dengan CSIDL_PERSONAL. |
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk file musik. Jalur umumnya adalah C:\Documents and Settings\User\My Documents\My Music. |
|
Versi 5.0. Direktori sistem file yang berfungsi sebagai repositori umum untuk file gambar. Jalur umumnya adalah C:\Documents and Settings\username\My Documents\My Pictures. |
|
Versi 6.0. Direktori sistem file yang berfungsi sebagai repositori umum untuk file video. Jalur umumnya adalah C:\Documents and Settings\username\My Documents\My Videos. |
|
Direktori sistem file yang berisi objek tautan yang mungkin ada di folder virtual Tempat Jaringan Saya . Ini tidak sama dengan CSIDL_NETWORK, yang mewakili akar namespace jaringan. Jalur umumnya adalah C:\Documents and Settings\username\NetHood. |
|
Folder virtual yang mewakili Network Neighborhood, akar hierarki namespace jaringan. |
|
Versi 6.0. Folder virtual yang mewakili item desktop Dokumen Saya. Ini setara dengan CSIDL_MYDOCUMENTS. Sebelumnya ke Versi 6.0. Direktori sistem file yang digunakan untuk menyimpan repositori umum dokumen pengguna secara fisik. Jalur umumnya adalah C:\Documents and Settings\username\My Documents. Ini harus dibedakan dari folder Dokumen Saya virtual di namespace. Untuk mengakses folder virtual tersebut, gunakan SHGetFolderLocation, yang mengembalikan ITEMIDLIST untuk lokasi virtual, atau lihat teknik yang dijelaskan dalam Mengelola Sistem File. |
|
Folder virtual yang memuat pencetak yang terinstal. |
|
Direktori sistem file yang berisi objek tautan yang bisa ada di folder virtual Printer . Jalur umumnya adalah C:\Documents and Settings\username\PrintHood. |
|
Versi 5.0. Folder profil pengguna. Jalur umumnya adalah C:\Users\username. Aplikasi tidak boleh membuat file atau folder pada tingkat ini; mereka harus meletakkan data mereka di bawah lokasi yang dimaksud oleh CSIDL_APPDATA atau CSIDL_LOCAL_APPDATA. Namun, jika Anda membuat Folder Yang Diketahui baru, akar profil yang dimaksud oleh CSIDL_PROFILE sesuai. |
|
Versi 5.0. Folder File Program. Jalur umumnya adalah C:\Program Files. |
|
|
|
Versi 5.0. Folder untuk komponen yang dibagikan di seluruh aplikasi. Jalur umumnya adalah C:\Program Files\Common. Hanya berlaku untuk Windows XP. |
|
|
|
Direktori sistem file yang berisi grup program pengguna (yang merupakan direktori sistem file sendiri). Jalur umumnya adalah C:\Documents and Settings\username\Start Menu\Programs. |
|
Direktori sistem file yang berisi pintasan ke dokumen pengguna yang terakhir digunakan. Jalur umumnya adalah C:\Documents and Settings\username\My Recent Documents. Untuk membuat pintasan di folder ini, gunakan SHAddToRecentDocs. Selain membuat pintasan, fungsi ini memperbarui daftar dokumen terbaru Shell dan menambahkan pintasan ke submenu Dokumen Terbaru Saya dari menu Mulai . |
|
Windows Vista. Direktori sistem file yang berisi data sumber daya. Jalur umumnya adalah C:\Windows\Resources. |
|
|
|
Direktori sistem file yang berisi item menu Kirim Ke . Jalur umumnya adalah C:\Documents and Settings\username\SendTo. |
|
Direktori sistem file yang berisi item menu Mulai . Jalur umumnya adalah C:\Documents and Settings\username\Start Menu. |
|
Direktori sistem file yang sesuai dengan grup program Startup pengguna. Sistem memulai program ini setiap kali pengguna terkait masuk. Jalur umumnya adalah C:\Documents and Settings\username\Start Menu\Programs\Startup. |
|
Versi 5.0. Folder Sistem Windows. Jalur umumnya adalah C:\Windows\System32. |
|
|
|
Direktori sistem file yang berfungsi sebagai repositori umum untuk templat dokumen. Jalur umumnya adalah C:\Documents and Settings\username\Templates. |
|
Versi 5.0. Direktori Windows atau SYSROOT. Ini sesuai dengan variabel lingkungan %windir% atau %SYSTEMROOT%. Jalur umumnya adalah C:\Windows. |
|
|
|
Versi 5.0. Gabungkan dengan CSIDL lain untuk memaksa pembuatan folder terkait jika tidak ada. |
|
Gabungkan dengan konstanta CSIDL lain untuk memastikan perluasan variabel lingkungan. |
|
Gabungkan dengan konstanta CSIDL lain, kecuali untuk CSIDL_FLAG_CREATE, untuk mengembalikan jalur folder yang belum diverifikasi tanpa upaya untuk membuat atau menginisialisasi folder. |
|
Gabungkan dengan konstanta CSIDL lain untuk memastikan pengambilan jalur sistem yang benar untuk folder, bebas dari tempat penampung alias seperti %USERPROFILE%, dikembalikan oleh SHGetFolderLocation. Bendera ini tidak berpengaruh pada jalur yang dikembalikan oleh SHGetFolderPath. |
|
|
|
Masker untuk nilai bendera CSIDL yang valid. |
Keterangan
Nilai-nilai ini menggantikan penggunaan variabel lingkungan untuk tujuan ini. Mereka pada gilirannya digantikan di Windows Vista dan kemudian oleh nilai KNOWNFOLDERID .
CSIDL digunakan bersama dengan salah satu dari empat fungsi Shell, SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocation, dan SHGetSpecialFolderPath, untuk mengambil jalur atau penunjuk folder khusus ke daftar pengidentifikasi item (PIDL).
Gabungkan CSIDL_FLAG_CREATE dengan CSIDL lainnya, kecuali untuk CSIDL_FLAG_DONT_VERIFY, untuk memaksa pembuatan folder terkait. CSIDL yang tersisa sesuai dengan folder sistem file atau folder virtual. Di mana CSIDL mengidentifikasi folder sistem file, jalur yang umum digunakan diberikan sebagai contoh. Jalur lain dapat digunakan. Beberapa CSIDL dapat dipetakan ke variabel lingkungan %VariableName% yang setara. CSIDL lebih dapat diandalkan, namun, dan harus digunakan jika memungkinkan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
Lihat juga