CSIDL

  • 發行項

注意

從 Windows Vista 起，這些值已由 KNOWNFOLDERID 值取代。 如需新常數的清單及其對應的 CSIDL 值，請參閱該主題。 為了方便起見，每個 CSIDL 值的對應 KNOWNFOLDERID 值也會在這裡加以記錄。

基於相容性考慮，Windows Vista 支援 CSIDL 系統。 不過，新的開發應該使用 KNOWNFOLDERID 值，而不是 CSIDL 值。

 

CSIDL (常數特殊專案識別碼清單) 值提供唯一的系統獨立方式，以識別應用程式經常使用的特殊資料夾，但可能沒有任何指定系統上的名稱或位置相同。 例如，系統資料夾可能是一個系統上的 「C：\Windows」，另一個系統上可能是 「C：\Winnt」。 這些常數定義于 Shlobj.h 中。

常數/值 Description
CSIDL_ADMINTOOLS
FOLDERID_AdminTools
 5.0 版。 檔案系統目錄，用於儲存個別使用者的系統管理工具。 MMC 會將自訂的主控台儲存到此目錄，而且會與使用者漫遊。
CSIDL_ALTSTARTUP
FOLDERID_Startup
 對應至使用者非本機啟動程式群組的檔案系統目錄。 這個值在 Windows Vista 中可辨識為回溯相容性，但資料夾本身已不存在。
CSIDL_APPDATA
FOLDERID_RoamingAppData
 4.71 版。 檔案系統目錄，可作為應用程式特定資料的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Application Data。
CSIDL_BITBUCKET
FOLDERID_RecycleBinFolder
 包含使用者 回收站中物件的虛擬資料夾。
CSIDL_CDBURN_AREA
FOLDERID_CDBurning
 6.0 版。 檔案系統目錄，做為等候寫入 CD 之檔案的暫存區域。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD 一般。
CSIDL_COMMON_ADMINTOOLS
FOLDERID_CommonAdminTools
 5.0 版。 檔案系統目錄，包含電腦之所有使用者的系統管理工具。
CSIDL_COMMON_ALTSTARTUP
FOLDERID_CommonStartup
 對應至所有使用者之非本機啟動程式群組的檔案系統目錄。 這個值在 Windows Vista 中可辨識為回溯相容性，但資料夾本身已不存在。
CSIDL_COMMON_APPDATA
FOLDERID_ProgramData
 5.0 版。 檔案系統目錄，其中包含所有使用者的應用程式資料。 典型的路徑是 C：\Documents and Settings\All Users\Application Data。 此資料夾用於非使用者特定的應用程式資料。 例如，應用程式可以儲存拼字檢查字典、美工圖案的資料庫，或CSIDL_COMMON_APPDATA資料夾中的記錄檔。 此資訊不會漫遊，而且可供任何使用電腦的人使用。
CSIDL_COMMON_DESKTOPDIRECTORY
FOLDERID_PublicDesktop
 檔案系統目錄，包含在所有使用者的桌面上出現的檔案和資料夾。 典型的路徑是 C：\Documents and Settings\All Users\Desktop。
CSIDL_COMMON_DOCUMENTS
FOLDERID_PublicDocuments
 檔案系統目錄，包含所有使用者共用的文件。 典型的路徑是 C：\Documents and Settings\All Users\Documents。
CSIDL_COMMON_FAVORITES
FOLDERID_Favorites
 檔案系統目錄，可作為所有使用者通用之我的最愛專案的通用存放庫。
CSIDL_COMMON_MUSIC
FOLDERID_PublicMusic
 6.0 版。 檔案系統目錄，做為所有使用者共用之音樂檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Music。
CSIDL_COMMON_OEM_LINKS
FOLDERID_CommonOEMLinks
 在 Windows Vista 中可辨識這個值，以取得回溯相容性，但不再使用資料夾本身。
CSIDL_COMMON_PICTURES
FOLDERID_PublicPictures
 6.0 版。 檔案系統目錄，做為所有使用者共用之影像檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Pictures。
CSIDL_COMMON_PROGRAMS
FOLDERID_CommonPrograms
 檔案系統目錄，其中包含所有使用者出現在 [ 開始 ] 功能表上之通用程式群組的目錄。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu\Programs。
CSIDL_COMMON_STARTMENU
FOLDERID_CommonStartMenu
 檔案系統目錄，包含在所有使用者的 [開始] 功能表上出現的程式和資料夾。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu。
CSIDL_COMMON_STARTUP
FOLDERID_CommonStartup
 檔案系統目錄，包含在所有使用者的 [啟動] 資料夾中出現的程式。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu\Programs\Startup。
CSIDL_COMMON_TEMPLATES
FOLDERID_CommonTemplates
 檔案系統目錄，包含所有使用者可用的範本。 典型的路徑是 C：\Documents and Settings\All Users\Templates。
CSIDL_COMMON_VIDEO
FOLDERID_PublicVideos
 6.0 版。 檔案系統目錄，做為所有使用者共用之視訊檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Videos。
CSIDL_COMPUTERSNEARME
FOLDERID_NetworkFolder
 代表工作組中其他電腦的資料夾。
CSIDL_CONNECTIONS
FOLDERID_ConnectionsFolder
 代表網路連線的虛擬資料夾，其中包含網路和撥號連線。
CSIDL_CONTROLS
FOLDERID_ControlPanelFolder
 包含主控台應用程式的圖示的虛擬資料夾。
CSIDL_COOKIES
FOLDERID_Cookies
 做為網際網路 Cookie 通用存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\Cookies。
CSIDL_DESKTOP
FOLDERID_Desktop
 代表 Windows 桌面的虛擬資料夾，命名空間的根目錄。
CSIDL_DESKTOPDIRECTORY
FOLDERID_Desktop
 用來實際將檔案物件儲存在桌面上的檔案系統目錄， (不會與桌面資料夾本身) 混淆。 典型的路徑是 C：\Documents and Settings\username\Desktop。
CSIDL_DRIVES
FOLDERID_ComputerFolder
 代表 [我的電腦] 的虛擬資料夾，其中包含本機電腦上的一切：儲存裝置、印表機和主控台。 資料夾也可以包含對應的網路磁碟機機。
CSIDL_FAVORITES
FOLDERID_Favorites
 檔案系統目錄，可作為使用者最愛專案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Favorites。
CSIDL_FONTS
FOLDERID_Fonts
 包含字型的虛擬資料夾。 典型的路徑是 C：\Windows\Fonts。
CSIDL_HISTORY
FOLDERID_History
 檔案系統目錄，可作為網際網路歷程記錄專案的通用存放庫。
CSIDL_INTERNET
FOLDERID_InternetFolder
 Internet Explorer 的虛擬資料夾。
CSIDL_INTERNET_CACHE
FOLDERID_InternetCache
 4.72 版。 檔案系統目錄，可作為臨時網際網路檔案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Temporary Internet Files。
CSIDL_LOCAL_APPDATA
FOLDERID_LocalAppData
 5.0 版。 檔案系統目錄，做為本機 (非roaming) 應用程式的資料存放庫。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Application Data。
CSIDL_MYDOCUMENTS
FOLDERID_Documents
 6.0 版。 代表 [我的文件] 桌面專案的虛擬資料夾。 這個值相當於 CSIDL_PERSONAL。
CSIDL_MYMUSIC
FOLDERID_Music
 做為音樂檔案通用存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\User\My Documents\My Music。
CSIDL_MYPICTURES
FOLDERID_Pictures
 5.0 版。 檔案系統目錄，做為映射檔的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\My Documents\My Pictures。
CSIDL_MYVIDEO
FOLDERID_Videos
 6.0 版。 檔案系統目錄，可作為影片檔案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\My Documents\My Videos。
CSIDL_NETHOOD
FOLDERID_NetHood
 檔案系統目錄，包含 [網路上的芳鄰] 虛擬資料夾中可能存在的連結物件。 它與 CSIDL_NETWORK不同，這代表網路命名空間根目錄。 典型的路徑是 C：\Documents and Settings\username\NetHood。
CSIDL_NETWORK
FOLDERID_NetworkFolder
 虛擬資料夾，代表網路鄰近地區，網路命名空間階層的根目錄。
CSIDL_PERSONAL
FOLDERID_Documents
 6.0 版。 代表 [我的文件] 桌面專案的虛擬資料夾。 這相當於 CSIDL_MYDOCUMENTS。
先前的版本為 6.0。 用來實際儲存使用者一般檔存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\My Documents。 這應該與命名空間中的虛擬 [我的文件] 資料夾區別。 若要存取該虛擬資料夾，請使用 SHGetFolderLocation，這會傳回虛擬位置 的 ITEMIDLIST ，或參考 管理檔案系統中所述的技術。
CSIDL_PRINTERS
FOLDERID_PrintersFolder
 包含已安裝印表機的虛擬資料夾。
CSIDL_PRINTHOOD
FOLDERID_PrintHood
 檔案系統目錄，包含 [印表機] 虛擬資料夾中可能存在的連結物件。 典型的路徑是 C：\Documents and Settings\username\PrintHood。
CSIDL_PROFILE
FOLDERID_Profile
 5.0 版。 使用者的設定檔資料夾。 典型的路徑是 C：\Users\username。 應用程式不應該在此層級建立檔案或資料夾;他們應該將其資料放在 CSIDL_APPDATA 或 CSIDL_LOCAL_APPDATA所參考的位置之下。 不過，如果您要建立新的已知資料夾，則設定檔根目錄CSIDL_PROFILE適當。
CSIDL_PROGRAM_FILES
FOLDERID_ProgramFiles
 5.0 版。 [程式檔案] 資料夾。 典型的路徑是 C：\Program Files。
CSIDL_PROGRAM_FILESX86
FOLDERID_ProgramFilesX86
CSIDL_PROGRAM_FILES_COMMON
FOLDERID_ProgramFilesCommon
 5.0 版。 表示跨應用程式共用之元件的資料夾。 典型的路徑是 C：\Program Files\Common。 僅適用于 Windows XP。
CSIDL_PROGRAM_FILES_COMMONX86
FOLDERID_ProgramFilesCommonX86
CSIDL_PROGRAMS
FOLDERID_Programs
 包含使用者程式群組的檔案系統目錄， (本身為檔案系統目錄) 。 典型的路徑是 C：\Documents and Settings\username\Start Menu\Programs。
CSIDL_RECENT
FOLDERID_Recent
 檔案系統目錄，其中包含使用者最近使用之檔的快捷方式。 典型的路徑是 C：\Documents and Settings\username\My Recent Documents。 若要在此資料夾中建立快捷方式，請使用 SHAddToRecentDocs。 除了建立快捷方式之外，此函式還會更新 Shell 最近的檔案清單，並將快捷方式新增至 [開始] 功能表的[我的最近使用的檔] 子功能表。
CSIDL_RESOURCES
FOLDERID_ResourceDir
 Windows Vista。 檔案系統目錄，包含資源資料。 典型的路徑是 C：\Windows\Resources。
CSIDL_RESOURCES_LOCALIZED
FOLDERID_LocalizedResourcesDir
CSIDL_SENDTO
FOLDERID_SendTo
 包含 [傳送至] 功能表項目的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\SendTo。
CSIDL_STARTMENU
FOLDERID_StartMenu
 包含 [開始 ] 功能表項目的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\Start Menu。
CSIDL_STARTUP
FOLDERID_Startup
 對應至使用者啟動程式群組的檔案系統目錄。 每當相關聯的使用者登入時，系統就會啟動這些程式。 典型的路徑是 C：\Documents and Settings\username\Start Menu\Programs\Startup。
CSIDL_SYSTEM
FOLDERID_System
 5.0 版。 Windows System 資料夾。 典型的路徑是 C：\Windows\System32。
CSIDL_SYSTEMX86
FOLDERID_SystemX86
CSIDL_TEMPLATES
FOLDERID_Templates
 檔案系統目錄，做為檔範本的通用存放庫。 典型的路徑是 C：\Documents 和 Settings\username\Templates。
CSIDL_WINDOWS
FOLDERID_Windows
 5.0 版。 Windows 目錄或 SYSROOT。 這個值對應至 %windir% 或 %SYSTEMROOT% 環境變數。 典型的路徑是 C：\Windows。
旗標
CSIDL_FLAG_CREATE
KF_FLAG_CREATE
 5.0 版。 結合另一個 CSIDL，如果關聯資料夾不存在，則強制建立關聯資料夾。
CSIDL_FLAG_DONT_UNEXPAND
KF_FLAG_DONT_UNEXPAND
 結合另一個 CSIDL 常數，以確保環境變數的擴充。
CSIDL_FLAG_DONT_VERIFY
KF_FLAG_DONT_VERIFY
 結合另一個 CSIDL 常數，除了 CSIDL_FLAG_CREATE之外，不嘗試建立或初始化資料夾，傳回未驗證的資料夾路徑。
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
 結合另一個 CSIDL 常數，以確保擷取資料夾真正的系統路徑，不含任何別名預留位置，例如 SHGetFolderLocation 所傳回的 %USERPROFILE%。 此旗標不會影響 SHGetFolderPath 所傳回的路徑。
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
 任何有效 CSIDL 旗標值的遮罩。

備註

這些值取代了針對此用途使用環境變數。 它們接著會由 KNOWNFOLDERID 值取代于 Windows Vista 和更新版本中。

CSIDL 會與四個 Shell 函式之一搭配使用：SHGetFolderLocation、SHGetFolderPath、SHGetSpecialFolderLocation和SHGetSpecialFolderPath，以擷取特殊資料夾的路徑或專案識別碼清單的指標， (PIDL) 。

結合 CSIDL_FLAG_CREATE 與任何其他 CSIDL，但 CSIDL_FLAG_DONT_VERIFY除外，強制建立相關聯的資料夾。 其餘 CSID 會對應至檔系統資料夾或虛擬資料夾。 其中 CSIDL 會識別檔系統資料夾，則會以範例方式提供常用的路徑。 可以使用其他路徑。 某些 CSIDL 可以對應至相等 的 %VariableName% 環境變數。 不過，CSID 比較可靠，而且應該盡可能使用。

規格需求

需求 值
標頭
Shlobj.h

另請參閱

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG