CreateDirectoryW 関数 (fileapi.h)

新しいディレクトリを作成します。 基になるファイル システムがファイルとディレクトリのセキュリティをサポートしている場合、関数は指定されたセキュリティ記述子を新しいディレクトリに適用します。

テンプレート ディレクトリを指定するには、 CreateDirectoryEx 関数を使用します。

この操作をトランザクション操作として実行するには、 CreateDirectoryTransacted 関数を使用します。

構文

BOOL CreateDirectoryW(
  [in]           LPCWSTR               lpPathName,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

パラメーター

[in] lpPathName

作成するディレクトリのパス。

既定では、名前はMAX_PATH文字に制限されています。 この制限を 32,767 文字のワイド文字に拡張するには、パスの先頭に "\\?\" を付加します。 詳細については、「ファイル、パス、および名前空間の名前付け」を参照してください。

[in, optional] lpSecurityAttributes

SECURITY_ATTRIBUTES構造体へのポインター。 構造体の lpSecurityDescriptor メンバーは、新しいディレクトリのセキュリティ記述子を指定します。 lpSecurityAttributes が NULL の場合、ディレクトリは既定のセキュリティ記述子を取得します。 ディレクトリの既定のセキュリティ記述子の ACL は、その親ディレクトリから継承されます。

このパラメーターを有効にするには、ターゲット ファイル システムがファイルとディレクトリのセキュリティをサポートする必要があります。 (これは、 GetVolumeInformation が FS_PERSISTENT_ACLSを返すときに示されます)。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 次のようなエラーが発生する可能性があります。

Remarks

NTFS ファイル システムなどの一部のファイル システムでは、個々のファイルとディレクトリの圧縮または暗号化がサポートされています。 このようなファイル システム用にフォーマットされたボリュームでは、新しいディレクトリは親ディレクトリの圧縮属性と暗号化属性を継承します。

アプリケーションは、FILE_FLAG_BACKUP_SEMANTICS フラグを設定して CreateFile を 呼び出すことによって、ディレクトリへのハンドル を 取得できます。 コード例については、「 CreateFile」を参照してください。

このオブジェクトのセキュリティ記述子に対してクエリを実行する継承関数をサポートするには、継承が有効であることをヒューリスティックに判断して報告できます。 詳細については、「 継承可能 ACE の自動伝達」を 参照してください。

Windows 8とWindows Server 2012では、この関数は次のテクノロジでサポートされています。

例

例については、「 ファイル属性の取得と変更」を参照してください。

要件

関連項目

CreateDirectoryEx

CreateDirectoryTransacted

CreateFile

ディレクトリの作成と削除

ディレクトリ管理機能

RemoveDirectory

SECURITY_ATTRIBUTES

SECURITY_INFORMATION