SHCreateDirectory 函数 (shlobj_core.h)

  • 项目

[SHCreateDirectory 可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]

创建新的文件系统文件夹。

语法

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

参数

[in, optional] hwnd

类型：HWND

父窗口的句柄。 如果未显示任何用户界面，则可以将此参数设置为 NULL 。

[in] pszPath

类型： PCWSTR

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含目录的完全限定路径。 此字符串的字符不应超过 MAX_PATH，包括终止 null 字符。

返回值

类型： int

如果成功，则返回 ERROR_SUCCESS 。 如果操作失败，可能会返回其他错误代码，包括此处列出的错误代码。 有关未专门列出的值，请参阅 系统错误代码。

返回代码 说明
ERROR_BAD_PATHNAME
 pszPath 参数已设置为相对路径。
ERROR_FILENAME_EXCED_RANGE
 pszPath 指向的路径太长。
ERROR_FILE_EXISTS
 目录存在。
ERROR_ALREADY_EXISTS
 目录存在。
ERROR_CANCELLED
 用户取消了操作。

注解

此函数创建一个文件系统文件夹，其完全限定路径由 pszPath 提供。 如果一个或多个中间文件夹不存在，则会创建它们。

若要在新文件夹上设置安全属性，请使用 SHCreateDirectoryEx。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)

另请参阅

SHCreateDirectoryEx