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