Csidl

참고

Windows Vista부터 이러한 값은 KNOWNFOLDERID 값으로 대체되었습니다. 새 상수 및 해당 CSIDL 값 목록은 해당 항목을 참조하세요. 편의를 위해 각 CSIDL 값에 해당하는 KNOWNFOLDERID 값도 여기에 기록됩니다.

호환성을 위해 CSIDL 시스템은 Windows Vista에서 지원됩니다. 그러나 새 개발에서는 CSIDL 값 대신 KNOWNFOLDERID 값을 사용해야 합니다.

 

CSIDL(상수 특수 항목 ID 목록) 값은 애플리케이션에서 자주 사용하는 특수 폴더를 식별하는 고유한 시스템 독립적 방법을 제공하지만 지정된 시스템에서는 이름이나 위치가 동일하지 않을 수 있습니다. 예를 들어 시스템 폴더는 한 시스템의 "C:\Windows"이고 다른 시스템의 경우 "C:\Winnt"일 수 있습니다. 이러한 상수는 Shlobj.h에 정의되어 있습니다.

상수/값 설명
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 Burning입니다.
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
인터넷 쿠키에 대한 공통 리포지토리 역할을 하는 파일 시스템 디렉터리입니다. 일반적인 경로는 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
인터넷 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. 로컬(비로밍) 애플리케이션의 데이터 리포지토리 역할을 하는 파일 시스템 디렉터리입니다. 일반적인 경로는 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입니다. 이 폴더는 네임스페이스의 가상 내 문서 폴더와 구별되어야 합니다. 해당 가상 폴더에 액세스하려면 가상 위치에 대한 ITEMIDLIST를 반환하는 SHGetFolderLocation을 사용하거나 파일 시스템 관리에 설명된 기술을 참조하세요.
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. Program Files 폴더입니다. 일반적인 경로는 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를 사용합니다. 이 함수는 바로 가기를 만드는 것 외에도 셸의 최근 문서 목록을 업데이트하고 시작 메뉴의 내 최근 문서 하위 메뉴에 바로 가기를 추가합니다.
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 and 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_FLAG_CREATE 제외한 다른 CSIDL 상수와 결합하여 폴더를 만들거나 초기화하지 않고 확인되지 않은 폴더 경로를 반환합니다.
CSIDL_FLAG_NO_ALIAS
KF_FLAG_NO_ALIAS
다른 CSIDL 상수와 결합하여 SHGetFolderLocation에서 반환한 별칭이 지정된 자리 표시자(예: %USERPROFILE%)가 없는 폴더의 실제 시스템 경로를 검색할 수 있도록 합니다. 이 플래그는 SHGetFolderPath에서 반환된 경로에 영향을 주지 않습니다.
CSIDL_FLAG_PER_USER_INIT
CSIDL_FLAG_MASK
유효한 CSIDL 플래그 값에 대한 마스크입니다.

설명

이러한 값은 이 목적을 위해 환경 변수의 사용을 대체합니다. 이 값은 Windows Vista에서 대체되고 나중에 KNOWNFOLDERID 값으로 대체됩니다.

CSIDL은 4개의 셸 함수인 SHGetFolderLocation, SHGetFolderPath, SHGetSpecialFolderLocationSHGetSpecialFolderPath 중 하나와 함께 사용하여 특수 폴더의 경로 또는 PIDL(항목 식별자 목록)에 대한 포인터를 검색합니다.

CSIDL_FLAG_CREATE CSIDL_FLAG_DONT_VERIFY 제외한 다른 CSIDL과 결합하여 연결된 폴더를 강제로 생성합니다. 나머지 CSIDL은 파일 시스템 폴더 또는 가상 폴더에 해당합니다. CSIDL이 파일 시스템 폴더를 식별하는 경우 일반적으로 사용되는 경로가 예로 제공됩니다. 다른 경로를 사용할 수 있습니다. 일부 CSIDL은 해당하는 %VariableName% 환경 변수에 매핑할 수 있습니다. 그러나 CSIDL은 더 안정적이며 가능한 경우 사용해야 합니다.

요구 사항

요구 사항
헤더
Shlobj.h

추가 정보

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG