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
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
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.
CSIDL_ALTSTARTUP
FOLDERID_Startup
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.
CSIDL_APPDATA
FOLDERID_RoamingAppData
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.
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
Folder virtual yang berisi objek di Keranjang Sampah pengguna.
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
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.
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
Versi 5.0. Direktori sistem file yang berisi alat administratif untuk semua pengguna komputer.
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
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.
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
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.
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
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.
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
Direktori sistem file yang berisi dokumen yang umum untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Documents.
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
Direktori sistem file yang berfungsi sebagai repositori umum untuk item favorit yang umum untuk semua pengguna.
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
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.
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
Nilai ini dikenali di Windows Vista untuk kompatibilitas mundur, tetapi folder itu sendiri tidak lagi digunakan.
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
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.
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
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.
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
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.
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
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.
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
Direktori sistem file yang berisi templat yang tersedia untuk semua pengguna. Jalur umumnya adalah C:\Documents and Settings\All Users\Templates.
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
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.
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
Folder yang mewakili komputer lain dalam grup kerja Anda.
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
Folder virtual yang mewakili Sambungan Jaringan, yang berisi sambungan jaringan dan putar-nomor.
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
Folder virtual yang berisi ikon untuk aplikasi Panel Kontrol.
CSIDL_COOKIES
FOLDERID_Cookies
Direktori sistem file yang berfungsi sebagai repositori umum untuk cookie Internet. Jalur umumnya adalah C:\Documents and Settings\username\Cookies.
CSIDL_DESKTOP
FOLDERID_Desktop
Folder virtual yang mewakili desktop Windows, akar namespace layanan.
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
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.
CSIDL_DRIVES
FOLDERID_ComputerFolder
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.
CSIDL_FAVORITES
FOLDERID_Favorites
Direktori sistem file yang berfungsi sebagai repositori umum untuk item favorit pengguna. Jalur umumnya adalah C:\Documents and Settings\username\Favorites.
CSIDL_FONTS
FOLDERID_Fonts
Folder virtual yang berisi font. Jalur umumnya adalah C:\Windows\Fonts.
CSIDL_HISTORY
FOLDERID_History
Direktori sistem file yang berfungsi sebagai repositori umum untuk item riwayat Internet.
CSIDL_INTERNET
FOLDERID_InternetFolder
Folder virtual untuk Internet Explorer.
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
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.
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
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.
CSIDL_MYDOCUMENTS
FOLDERID_Documents
Versi 6.0. Folder virtual yang mewakili item desktop Dokumen Saya. Nilai ini setara dengan CSIDL_PERSONAL.
CSIDL_MYMUSIC
FOLDERID_Music
Direktori sistem file yang berfungsi sebagai repositori umum untuk file musik. Jalur umumnya adalah C:\Documents and Settings\User\My Documents\My Music.
CSIDL_MYPICTURES
FOLDERID_Pictures
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.
CSIDL_MYVIDEO
FOLDERID_Videos
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.
CSIDL_NETHOOD
FOLDERID_NetHood
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.
CSIDL_NETWORK
FOLDERID_NetworkFolder
Folder virtual yang mewakili Network Neighborhood, akar hierarki namespace jaringan.
CSIDL_PERSONAL
FOLDERID_Documents
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.
CSIDL_PRINTERS
FOLDERID_PrintersFolder
Folder virtual yang memuat pencetak yang terinstal.
CSIDL_PRINTHOOD
FOLDERID_PrintHood
Direktori sistem file yang berisi objek tautan yang bisa ada di folder virtual Printer . Jalur umumnya adalah C:\Documents and Settings\username\PrintHood.
CSIDL_PROFILE
FOLDERID_Profile
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.
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
Versi 5.0. Folder File Program. Jalur umumnya adalah C:\Program Files.
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
Versi 5.0. Folder untuk komponen yang dibagikan di seluruh aplikasi. Jalur umumnya adalah C:\Program Files\Common. Hanya berlaku untuk Windows XP.
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
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.
CSIDL_RECENT
FOLDERID_Recent
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 .
CSIDL_RESOURCES
FOLDERID_ResourceDir
Windows Vista. Direktori sistem file yang berisi data sumber daya. Jalur umumnya adalah C:\Windows\Resources.
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
Direktori sistem file yang berisi item menu Kirim Ke . Jalur umumnya adalah C:\Documents and Settings\username\SendTo.
CSIDL_STARTMENU
FOLDERID_StartMenu
Direktori sistem file yang berisi item menu Mulai . Jalur umumnya adalah C:\Documents and Settings\username\Start Menu.
CSIDL_STARTUP
FOLDERID_Startup
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.
CSIDL_SYSTEM
FOLDERID_System
Versi 5.0. Folder Sistem Windows. Jalur umumnya adalah C:\Windows\System32.
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
Direktori sistem file yang berfungsi sebagai repositori umum untuk templat dokumen. Jalur umumnya adalah C:\Documents and Settings\username\Templates.
CSIDL_WINDOWS
FOLDERID_Windows
Versi 5.0. Direktori Windows atau SYSROOT. Ini sesuai dengan variabel lingkungan %windir% atau %SYSTEMROOT%. Jalur umumnya adalah C:\Windows.
Bendera
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
Versi 5.0. Gabungkan dengan CSIDL lain untuk memaksa pembuatan folder terkait jika tidak ada.
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
Gabungkan dengan konstanta CSIDL lain untuk memastikan perluasan variabel lingkungan.
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
Gabungkan dengan konstanta CSIDL lain, kecuali untuk CSIDL_FLAG_CREATE, untuk mengembalikan jalur folder yang belum diverifikasi tanpa upaya untuk membuat atau menginisialisasi folder.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
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.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
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
Shlobj.h

Lihat juga

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG