CreateDirectory 関数 (winbase.h)
新しいディレクトリを作成します。 基になるファイル システムがファイルとディレクトリのセキュリティをサポートしている場合、関数は指定されたセキュリティ記述子を新しいディレクトリに適用します。
テンプレート ディレクトリを指定するには、 CreateDirectoryEx 関数を使用します。
この操作をトランザクション操作として実行するには、 CreateDirectoryTransacted 関数を使用します。
構文
BOOL CreateDirectory(
[in] LPCTSTR lpPathName,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
パラメーター
[in] lpPathName
作成するディレクトリのパス。
この関数の ANSI バージョンでは、248 文字のパスに既定の文字列サイズ制限があります (MAX_PATH - 8.3 ファイル名に十分な領域)。 この制限を 32,767 文字のワイド文字に拡張するには、Unicode バージョンの 関数を呼び出し、パスの前に "\?" を付加します。 詳細については、「ファイルの名前付け」を参照してください。
[in, optional] lpSecurityAttributes
SECURITY_ATTRIBUTES構造体へのポインター。 構造体の lpSecurityDescriptor メンバーは、新しいディレクトリのセキュリティ記述子を指定します。 lpSecurityAttributes が NULL の場合、ディレクトリは既定のセキュリティ記述子を取得します。 ディレクトリの既定のセキュリティ記述子の ACL は、その親ディレクトリから継承されます。
このパラメーターを有効にするには、ターゲット ファイル システムがファイルとディレクトリのセキュリティをサポートする必要があります。 (これは、 GetVolumeInformation が FS_PERSISTENT_ACLSを返すときに示されます)。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 次のようなエラーが発生する可能性があります。
| リターン コード | 説明 |
|---|---|
|
指定したディレクトリは既に存在します。 |
|
1 つ以上の中間ディレクトリが存在しません。この関数は、パス内に最後のディレクトリのみを作成します。 |
注釈
NTFS ファイル システムなどの一部のファイル システムでは、個々のファイルとディレクトリの圧縮または暗号化がサポートされています。 このようなファイル システム用にフォーマットされたボリュームでは、新しいディレクトリは親ディレクトリの圧縮属性と暗号化属性を継承します。
アプリケーションは、FILE_FLAG_BACKUP_SEMANTICS フラグを設定して CreateFile を 呼び出すことによって、ディレクトリへのハンドル を 取得できます。 コード例については、「 CreateFile」を参照してください。
このオブジェクトのセキュリティ記述子に対してクエリを実行する継承関数をサポートするには、継承が有効であることをヒューリスティックに判断して報告できます。 詳細については、「 継承可能 ACE の自動伝達」を 参照してください。
Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。
| テクノロジ | サポートされています |
|---|---|
| サーバー メッセージ ブロック (SMB) 3.0 プロトコル | はい |
| SMB 3.0 Transparent Failover (TFO) | はい |
| スケールアウト ファイル共有 (SO) を使う SMB 3.0 | はい |
| クラスターの共有ボリューム ファイル システム (CsvFS) | はい |
| Resilient File System (ReFS) | はい |
例
例については、「 ファイル属性の取得と変更」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |