CreateDirectory2W 関数 (fileapi.h)

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

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

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

構文

HANDLE CreateDirectory2W(
  LPCWSTR               lpPathName,
  DWORD                 dwDesiredAccess,
  DWORD                 dwShareMode,
  DIRECTORY_FLAGS       DirectoryFlags,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

パラメーター

lpPathName

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

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

dwDesiredAccess

呼び出し元がディレクトリに対して必要とするアクセスの種類を表す ACCESS_MASK 値。 システム定義 dwDesiredAccess フラグのセットは、次の特定のアクセス権ディレクトリ ファイル オブジェクトを決定します。

dwShareMode

呼び出し元がファイルで使用する共有アクセスの種類。0、または次の値の 1 つまたは組み合わせとして使用します。

DirectoryFlags

このパラメーターには、 DIRECTORY_FLAGSの組み合わせを含めることができます。

lpSecurityAttributes

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

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

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

考えられるエラーは次のとおりです。

注釈

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

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

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

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

例示

次の例では、 CreateDirectory2 関数を使用して新しいディレクトリを作成します。 新しいディレクトリは、 FILE_LIST_DIRECTORY と SYNCHRONIZE アクセス権を使用して作成されます。 新しいディレクトリも FILE_SHARE_READ 共有モードで作成されます。これにより、他のプロセスがディレクトリを開いて読み取りアクセスできるようになります。

// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF 
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 
// PARTICULAR PURPOSE. 
// 
// Copyright (C) Microsoft. All rights reserved 
#include <Windows.h>
#include <stdio.h>
#include <strsafe.h>

int main(int argc, wchar_t* argv[])
{
    WCHAR filePath[MAX_PATH] = { 0 };

    // Create a directory to put a file into, that can't be deleted
    // and redirected before this handle is closed.
    HANDLE hDirectory = CreateDirectory2(argv[1],
        FILE_LIST_DIRECTORY | SYNCHRONIZE,
        FILE_SHARE_READ,
        DIRECTORY_FLAGS_NONE,
        NULL,
        NULL);
    if (hDirectory == INVALID_HANDLE_VALUE)
    {
        // Handle the error.
        printf("CreateDirectory2 failed (%d)\n", GetLastError());
        return (1);
    }

    StringCchPrintf(filePath,
        ARRAYSIZE(filePath),
        L"%ws\\example.test",
        argv[1]);

    HANDLE hFile = CreateFile3(filePath,
        GENERIC_ALL,
        FILE_SHARE_READ,
        CREATE_ALWAYS,
        NULL);
    if (hFile == INVALID_HANDLE_VALUE)
    {
        // Handle the error.
        CloseHandle(hDirectory);
        printf("CreateFile3 failed (%d)\n", GetLastError());
        return (1);
    }

    CloseHandle(hFile);
    CloseHandle(hDirectory);
    return (0);
}

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

必要条件

こちらもご覧ください

CreateFile3

DeleteFile2

RemoveDirectory2