Csidl

[アーティクル]
06/13/2023

注意

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

次の方法で共有

Csidl

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース