CSIDL
注意
從 Windows Vista 起，這些值已由 KNOWNFOLDERID 值取代。 如需新常數的清單及其對應的 CSIDL 值，請參閱該主題。 為了方便起見，每個 CSIDL 值的對應 KNOWNFOLDERID 值也會在這裡加以記錄。
基於相容性考慮，Windows Vista 支援 CSIDL 系統。 不過，新的開發應該使用 KNOWNFOLDERID 值，而不是 CSIDL 值。
CSIDL (常數特殊專案識別碼清單) 值提供唯一的系統獨立方式，以識別應用程式經常使用的特殊資料夾，但可能沒有任何指定系統上的名稱或位置相同。 例如，系統資料夾可能是一個系統上的 「C：\Windows」，另一個系統上可能是 「C：\Winnt」。 這些常數定義于 Shlobj.h 中。
| 常數/值 | Description |
|---|---|
|
5.0 版。 檔案系統目錄，用於儲存個別使用者的系統管理工具。 MMC 會將自訂的主控台儲存到此目錄，而且會與使用者漫遊。 |
|
對應至使用者非本機啟動程式群組的檔案系統目錄。 這個值在 Windows Vista 中可辨識為回溯相容性，但資料夾本身已不存在。 |
|
4.71 版。 檔案系統目錄，可作為應用程式特定資料的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Application Data。 |
|
包含使用者 回收站中物件的虛擬資料夾。 |
|
6.0 版。 檔案系統目錄，做為等候寫入 CD 之檔案的暫存區域。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Application Data\Microsoft\CD 一般。 |
|
5.0 版。 檔案系統目錄，包含電腦之所有使用者的系統管理工具。 |
|
對應至所有使用者之非本機啟動程式群組的檔案系統目錄。 這個值在 Windows Vista 中可辨識為回溯相容性，但資料夾本身已不存在。 |
|
5.0 版。 檔案系統目錄，其中包含所有使用者的應用程式資料。 典型的路徑是 C：\Documents and Settings\All Users\Application Data。 此資料夾用於非使用者特定的應用程式資料。 例如，應用程式可以儲存拼字檢查字典、美工圖案的資料庫，或CSIDL_COMMON_APPDATA資料夾中的記錄檔。 此資訊不會漫遊，而且可供任何使用電腦的人使用。 |
|
檔案系統目錄，包含在所有使用者的桌面上出現的檔案和資料夾。 典型的路徑是 C：\Documents and Settings\All Users\Desktop。 |
|
檔案系統目錄，包含所有使用者共用的文件。 典型的路徑是 C：\Documents and Settings\All Users\Documents。 |
|
檔案系統目錄，可作為所有使用者通用之我的最愛專案的通用存放庫。 |
|
6.0 版。 檔案系統目錄，做為所有使用者共用之音樂檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Music。 |
|
在 Windows Vista 中可辨識這個值，以取得回溯相容性，但不再使用資料夾本身。 |
|
6.0 版。 檔案系統目錄，做為所有使用者共用之影像檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Pictures。 |
|
檔案系統目錄，其中包含所有使用者出現在 [ 開始 ] 功能表上之通用程式群組的目錄。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu\Programs。 |
|
檔案系統目錄，包含在所有使用者的 [開始] 功能表上出現的程式和資料夾。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu。 |
|
檔案系統目錄，包含在所有使用者的 [啟動] 資料夾中出現的程式。 典型的路徑是 C：\Documents and Settings\All Users\Start Menu\Programs\Startup。 |
|
檔案系統目錄，包含所有使用者可用的範本。 典型的路徑是 C：\Documents and Settings\All Users\Templates。 |
|
6.0 版。 檔案系統目錄，做為所有使用者共用之視訊檔案的儲存機制。 典型的路徑是 C：\Documents and Settings\All Users\Documents\My Videos。 |
|
代表工作組中其他電腦的資料夾。 |
|
代表網路連線的虛擬資料夾，其中包含網路和撥號連線。 |
|
包含主控台應用程式的圖示的虛擬資料夾。 |
|
做為網際網路 Cookie 通用存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\Cookies。 |
|
代表 Windows 桌面的虛擬資料夾，命名空間的根目錄。 |
|
用來實際將檔案物件儲存在桌面上的檔案系統目錄， (不會與桌面資料夾本身) 混淆。 典型的路徑是 C：\Documents and Settings\username\Desktop。 |
|
代表 [我的電腦] 的虛擬資料夾，其中包含本機電腦上的一切：儲存裝置、印表機和主控台。 資料夾也可以包含對應的網路磁碟機機。 |
|
檔案系統目錄，可作為使用者最愛專案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Favorites。 |
|
包含字型的虛擬資料夾。 典型的路徑是 C：\Windows\Fonts。 |
|
檔案系統目錄，可作為網際網路歷程記錄專案的通用存放庫。 |
|
Internet Explorer 的虛擬資料夾。 |
|
4.72 版。 檔案系統目錄，可作為臨時網際網路檔案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Temporary Internet Files。 |
|
5.0 版。 檔案系統目錄，做為本機 (非roaming) 應用程式的資料存放庫。 典型的路徑是 C：\Documents and Settings\username\Local Settings\Application Data。 |
|
6.0 版。 代表 [我的文件] 桌面專案的虛擬資料夾。 這個值相當於 CSIDL_PERSONAL。 |
|
做為音樂檔案通用存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\User\My Documents\My Music。 |
|
5.0 版。 檔案系統目錄，做為映射檔的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\My Documents\My Pictures。 |
|
6.0 版。 檔案系統目錄，可作為影片檔案的通用存放庫。 典型的路徑是 C：\Documents and Settings\username\My Documents\My Videos。 |
|
檔案系統目錄，包含 [網路上的芳鄰] 虛擬資料夾中可能存在的連結物件。 它與 CSIDL_NETWORK不同，這代表網路命名空間根目錄。 典型的路徑是 C：\Documents and Settings\username\NetHood。 |
|
虛擬資料夾，代表網路鄰近地區，網路命名空間階層的根目錄。 |
|
6.0 版。 代表 [我的文件] 桌面專案的虛擬資料夾。 這相當於 CSIDL_MYDOCUMENTS。 先前的版本為 6.0。 用來實際儲存使用者一般檔存放庫的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\My Documents。 這應該與命名空間中的虛擬 [我的文件] 資料夾區別。 若要存取該虛擬資料夾，請使用 SHGetFolderLocation，這會傳回虛擬位置 的 ITEMIDLIST ，或參考 管理檔案系統中所述的技術。 |
|
包含已安裝印表機的虛擬資料夾。 |
|
檔案系統目錄，包含 [印表機] 虛擬資料夾中可能存在的連結物件。 典型的路徑是 C：\Documents and Settings\username\PrintHood。 |
|
5.0 版。 使用者的設定檔資料夾。 典型的路徑是 C：\Users\username。 應用程式不應該在此層級建立檔案或資料夾;他們應該將其資料放在 CSIDL_APPDATA 或 CSIDL_LOCAL_APPDATA所參考的位置之下。 不過，如果您要建立新的已知資料夾，則設定檔根目錄CSIDL_PROFILE適當。 |
|
5.0 版。 [程式檔案] 資料夾。 典型的路徑是 C：\Program Files。 |
|
|
|
5.0 版。 表示跨應用程式共用之元件的資料夾。 典型的路徑是 C：\Program Files\Common。 僅適用于 Windows XP。 |
|
|
|
包含使用者程式群組的檔案系統目錄， (本身為檔案系統目錄) 。 典型的路徑是 C：\Documents and Settings\username\Start Menu\Programs。 |
|
檔案系統目錄，其中包含使用者最近使用之檔的快捷方式。 典型的路徑是 C：\Documents and Settings\username\My Recent Documents。 若要在此資料夾中建立快捷方式，請使用 SHAddToRecentDocs。 除了建立快捷方式之外，此函式還會更新 Shell 最近的檔案清單，並將快捷方式新增至 [開始] 功能表的[我的最近使用的檔] 子功能表。 |
|
Windows Vista。 檔案系統目錄，包含資源資料。 典型的路徑是 C：\Windows\Resources。 |
|
|
|
包含 [傳送至] 功能表項目的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\SendTo。 |
|
包含 [開始 ] 功能表項目的檔案系統目錄。 典型的路徑是 C：\Documents and Settings\username\Start Menu。 |
|
對應至使用者啟動程式群組的檔案系統目錄。 每當相關聯的使用者登入時，系統就會啟動這些程式。 典型的路徑是 C：\Documents and Settings\username\Start Menu\Programs\Startup。 |
|
5.0 版。 Windows System 資料夾。 典型的路徑是 C：\Windows\System32。 |
|
|
|
檔案系統目錄，做為檔範本的通用存放庫。 典型的路徑是 C：\Documents 和 Settings\username\Templates。 |
|
5.0 版。 Windows 目錄或 SYSROOT。 這個值對應至 %windir% 或 %SYSTEMROOT% 環境變數。 典型的路徑是 C：\Windows。 |
|
|
|
5.0 版。 結合另一個 CSIDL，如果關聯資料夾不存在，則強制建立關聯資料夾。 |
|
結合另一個 CSIDL 常數，以確保環境變數的擴充。 |
|
結合另一個 CSIDL 常數，除了 CSIDL_FLAG_CREATE之外，不嘗試建立或初始化資料夾，傳回未驗證的資料夾路徑。 |
|
結合另一個 CSIDL 常數，以確保擷取資料夾真正的系統路徑，不含任何別名預留位置，例如 SHGetFolderLocation 所傳回的 %USERPROFILE%。 此旗標不會影響 SHGetFolderPath 所傳回的路徑。 |
|
|
|
任何有效 CSIDL 旗標值的遮罩。 |
備註
這些值取代了針對此用途使用環境變數。 它們接著會由 KNOWNFOLDERID 值取代于 Windows Vista 和更新版本中。
CSIDL 會與四個 Shell 函式之一搭配使用：SHGetFolderLocation、SHGetFolderPath、SHGetSpecialFolderLocation和SHGetSpecialFolderPath，以擷取特殊資料夾的路徑或專案識別碼清單的指標， (PIDL) 。
結合 CSIDL_FLAG_CREATE 與任何其他 CSIDL，但 CSIDL_FLAG_DONT_VERIFY除外，強制建立相關聯的資料夾。 其餘 CSID 會對應至檔系統資料夾或虛擬資料夾。 其中 CSIDL 會識別檔系統資料夾，則會以範例方式提供常用的路徑。 可以使用其他路徑。 某些 CSIDL 可以對應至相等 的 %VariableName% 環境變數。 不過，CSID 比較可靠，而且應該盡可能使用。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
另請參閱