CreateDirectory2A 函数 （fileapi.h）

新建目录。 如果基础文件系统支持文件和目录的安全性，该函数会将指定的安全描述符应用于新目录。

若要指定模板目录，请使用 CreateDirectoryEx 函数。

若要将此作作为事务处理作执行，请使用 CreateDirectoryTransacted 函数。

语法

HANDLE CreateDirectory2A(
  LPCSTR                lpPathName,
  DWORD                 dwDesiredAccess,
  DWORD                 dwShareMode,
  DIRECTORY_FLAGS       DirectoryFlags,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

参数

lpPathName

要创建的目录的路径。

默认情况下，名称限制为 MAX_PATH 个字符。 若要将此限制扩展到 32,767 宽字符，请将“\\？\”前面追加到路径。 有关详细信息，请参阅 命名文件、路径和命名空间。

dwDesiredAccess

表示调用方对目录所需的访问类型的 ACCESS_MASK 值。 系统定义的 dwDesiredAccess 标志集确定以下特定的访问权限目录文件对象：

dwShareMode

调用方想要在文件中使用的共享访问类型，为零，或用作以下值的一个或多个组合：

DirectoryFlags

此参数可以包含 DIRECTORY_FLAGS的组合。

lpSecurityAttributes

指向 SECURITY_ATTRIBUTES 结构的指针。 结构的 lpSecurityDescriptor 成员为新目录指定安全描述符。 如果 lpSecurityAttributes 为 NULL，则目录将获取默认的安全描述符。 目录的默认安全描述符中的 ACL 继承自其父目录。

目标文件系统必须支持对文件和目录的安全性，才能使此参数生效。 （当 GetVolumeInformation 返回 FS_PERSISTENT_ACLS 时，指示此项。

返回值

如果函数成功，则返回值为非零。

如果函数失败，则返回值INVALID_HANDLE_VALUE。 若要获取扩展的错误信息，请调用 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