Csidl

  • [アーティクル]

注意

Windows Vista の時点では、これらの値は KNOWNFOLDERID 値に置き換えられました。 新しい定数とそれに対応する CSIDL 値の一覧については、そのトピックを参照してください。 便宜上、CSIDL 値ごとに対応する KNOWNFOLDERID 値もここに示されています。

互換性上の理由から、Windows Vista では CSIDL システムがサポートされています。 ただし、新しい開発では、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
 インターネット Cookie の共通リポジトリとして機能するファイル システム ディレクトリ。 一般的なパスは C:\Documents と 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 と Settings\username\Favorites です。
CSIDL_FONTS
FOLDERID_Fonts
 フォントが含まれる仮想フォルダー。 一般的なパスは C:\Windows\Fonts です。
CSIDL_HISTORY
FOLDERID_History
 インターネット履歴項目の共通リポジトリとして機能するファイル システム ディレクトリ。
CSIDL_INTERNET
FOLDERID_InternetFolder
 インターネット エクスプローラー用の仮想フォルダー。
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
 ネットワーク名前空間階層のルートである Network Neighborhood を表す仮想フォルダー。
CSIDL_PERSONAL
FOLDERID_Documents
 バージョン 6.0。 マイ ドキュメント デスクトップ項目を表す仮想フォルダー。 これは 、CSIDL_MYDOCUMENTSと同じです。
バージョン 6.0 より前。 ユーザーのドキュメントの共通リポジトリを物理的に格納するために使用されるファイル システム ディレクトリ。 一般的なパスは C:\Documents と 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 と 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 と Settings\username\SendTo です。
CSIDL_STARTMENU
FOLDERID_StartMenu
 [スタート] メニュー項目を含むファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\Start Menu です。
CSIDL_STARTUP
FOLDERID_Startup
 ユーザーのスタートアップ プログラム グループに対応するファイル システム ディレクトリ。 システムは、関連付けられたユーザーがログオンするたびに、これらのプログラムを開始します。 一般的なパスは C:\Documents and Settings\username\Start Menu\Programs\Startup です。
CSIDL_SYSTEM
FOLDERID_System
 バージョン 5.0。 Windows のシステム フォルダー。 一般的なパスは 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 です。
Flags
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 は、特別なフォルダーのパスまたは項目識別子リスト (PIDL) へのポインターを取得するために、4 つのシェル関数 SHGetFolderLocation、 SHGetFolderPath、 SHGetSpecialFolderLocation、 および SHGetSpecialFolderPath のいずれかと組み合わせて使用されます。

CSIDL_FLAG_CREATEを他の CSIDL (CSIDL_FLAG_DONT_VERIFYを除く) と組み合わせて、関連付けられたフォルダーを強制的に作成します。 残りの CSIDLs は、ファイル システム フォルダーまたは仮想フォルダーのいずれかに対応します。 CSIDL がファイル システム フォルダーを識別する場合、一般的に使用されるパスが例として示されます。 他のパスを使用できます。 一部の CSIDLs は、同等の %VariableName% 環境変数にマップできます。 ただし、CSIDL の方が信頼性が高く、可能であれば使用する必要があります。

要件

要件 値
ヘッダー
Shlobj.h

こちらもご覧ください

SHGetFolderLocation

SHGetFolderPath

SHGetSpecialFolderLocation

SHGetSpecialFolderPath

KNOWN_FOLDER_FLAG