Csidl
注意
Windows Vista の時点では、これらの値は KNOWNFOLDERID 値に置き換えられました。 新しい定数とそれに対応する CSIDL 値の一覧については、そのトピックを参照してください。 便宜上、CSIDL 値ごとに対応する KNOWNFOLDERID 値もここに示されています。
互換性上の理由から、Windows Vista では CSIDL システムがサポートされています。 ただし、新しい開発では、CSIDL 値ではなく KNOWNFOLDERID 値を使用する必要があります。
CSIDL (定数特殊項目 ID リスト) の値は、アプリケーションで頻繁に使用される特殊なフォルダーを識別する一意のシステムに依存しない方法を提供しますが、特定のシステム上で同じ名前や場所を持たない可能性があります。 たとえば、システム フォルダーは、あるシステムでは "C:\Windows"、別のシステムでは "C:\Winnt" になります。 これらの定数は Shlobj.h で定義されています。
定数/値 | 説明 |
---|---|
|
バージョン 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 Burning です。 |
|
バージョン 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 と Settings\username\Cookies です。 |
|
名前空間のルートである Windows デスクトップを表す仮想フォルダー。 |
|
デスクトップにファイル オブジェクトを物理的に格納するために使用されるファイル システム ディレクトリ (デスクトップ フォルダー自体と混同しないように)。 一般的なパスは C:\Documents and Settings\username\Desktop です。 |
|
ローカル コンピューター上のすべての記憶域デバイス、プリンター、コントロール パネルを含む、マイ コンピューターを表す仮想フォルダー。 フォルダーには、マップされたネットワーク ドライブを含めることもできます。 |
|
ユーザーのお気に入りの項目の共通リポジトリとして機能するファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\Favorites です。 |
|
フォントが含まれる仮想フォルダー。 一般的なパスは C:\Windows\Fonts です。 |
|
インターネット履歴項目の共通リポジトリとして機能するファイル システム ディレクトリ。 |
|
インターネット エクスプローラー用の仮想フォルダー。 |
|
バージョン 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 です。 |
|
ネットワーク名前空間階層のルートである Network Neighborhood を表す仮想フォルダー。 |
|
バージョン 6.0。 マイ ドキュメント デスクトップ項目を表す仮想フォルダー。 これは 、CSIDL_MYDOCUMENTSと同じです。 バージョン 6.0 より前。 ユーザーのドキュメントの共通リポジトリを物理的に格納するために使用されるファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\My Documents です。 これは、名前空間内の仮想 マイ ドキュメント フォルダーと区別する必要があります。 その仮想フォルダーにアクセスするには、仮想場所の ITEMIDLIST を返す SHGetFolderLocation を使用するか、「ファイル システムの管理」で説明されている手法を参照してください。 |
|
インストールされているプリンターを含む仮想フォルダー。 |
|
[プリンター] 仮想フォルダーに存在できるリンク オブジェクトを格納するファイル システム ディレクトリ。 一般的なパスは C:\Documents and Settings\username\PrintHood です。 |
|
バージョン 5.0。 ユーザーのプロファイル フォルダー。 一般的なパスは C:\Users\username です。 アプリケーションでは、このレベルでファイルやフォルダーを作成しないでください。CSIDL_APPDATAまたはCSIDL_LOCAL_APPDATAによって参照される場所の下にデータを配置する必要があります。 ただし、新しい既知のフォルダーを作成する場合は、CSIDL_PROFILEによって参照されるプロファイル ルートが適切です。 |
|
バージョン 5.0。 Program Files フォルダー。 一般的なパスは C:\Program Files です。 |
|
|
|
バージョン 5.0。 アプリケーション間で共有されるコンポーネントを格納するフォルダー。 一般的なパスは C:\Program Files\Common です。 Windows XP でのみ有効です。 |
|
|
|
ユーザーのプログラム グループ (それ自体がファイル システム ディレクトリ) を含むファイル システム ディレクトリ。 一般的なパスは C:\Documents and Settings\username\Start Menu\Programs です。 |
|
ユーザーの最近使用したドキュメントへのショートカットを含むファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\My Recent Documents です。 このフォルダーにショートカットを作成するには、 SHAddToRecentDocs を使用します。 この関数は、ショートカットの作成に加えて、シェルの最近使用したドキュメントの一覧を更新し、[スタート] メニューの [最近使用したドキュメント] サブメニューにショートカットを追加します。 |
|
Windows Vista リソース データを格納するファイル システム ディレクトリ。 一般的なパスは C:\Windows\Resources です。 |
|
|
|
[送信先] メニュー項目を含むファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\SendTo です。 |
|
[スタート] メニュー項目を含むファイル システム ディレクトリ。 一般的なパスは C:\Documents と Settings\username\Start Menu です。 |
|
ユーザーのスタートアップ プログラム グループに対応するファイル システム ディレクトリ。 システムは、関連付けられたユーザーがログオンするたびに、これらのプログラムを開始します。 一般的なパスは C:\Documents and Settings\username\Start Menu\Programs\Startup です。 |
|
バージョン 5.0。 Windows のシステム フォルダー。 一般的なパスは C:\Windows\System32 です。 |
|
|
|
ドキュメント テンプレートの共通リポジトリとして機能するファイル システム ディレクトリ。 一般的なパスは C:\Documents and Settings\username\Templates です。 |
|
バージョン 5.0。 Windows ディレクトリまたは SYSROOT。 これは、%windir% 環境変数または %SYSTEMROOT% 環境変数に対応します。 一般的なパスは C:\Windows です。 |
|
|
|
バージョン 5.0。 別の CSIDL と組み合わせて、関連付けられたフォルダーが存在しない場合は強制的に作成します。 |
|
別の CSIDL 定数と組み合わせて、環境変数を確実に拡張します。 |
|
CSIDL_FLAG_CREATEを除く別の CSIDL 定数と組み合わせて、フォルダーの作成または初期化を試みずに未確認のフォルダー パスを返します。 |
|
別の CSIDL 定数と組み合わせて、SHGetFolderLocation によって返される %USERPROFILE% などのエイリアス付きプレースホルダーを含まない、フォルダーの真のシステム パスを確実に取得できるようにします。 このフラグは、SHGetFolderPath によって返されるパスには影響しません。 |
|
|
|
有効な CSIDL フラグ値のマスク。 |
注釈
これらの値は、この目的で環境変数を使用するよりも優先されます。 これらは、Windows Vista 以降では KNOWNFOLDERID 値に置き換えられます。
CSIDL は、特別なフォルダーのパスまたは項目識別子リスト (PIDL) へのポインターを取得するために、4 つのシェル関数 SHGetFolderLocation、 SHGetFolderPath、 SHGetSpecialFolderLocation、 および SHGetSpecialFolderPath のいずれかと組み合わせて使用されます。
CSIDL_FLAG_CREATEを他の CSIDL (CSIDL_FLAG_DONT_VERIFYを除く) と組み合わせて、関連付けられたフォルダーを強制的に作成します。 残りの CSIDLs は、ファイル システム フォルダーまたは仮想フォルダーのいずれかに対応します。 CSIDL がファイル システム フォルダーを識別する場合、一般的に使用されるパスが例として示されます。 他のパスを使用できます。 一部の CSIDLs は、同等の %VariableName% 環境変数にマップできます。 ただし、CSIDL の方が信頼性が高く、可能であれば使用する必要があります。
要件
要件 | 値 |
---|---|
ヘッダー |
|
こちらもご覧ください