SHCreateDirectoryExW 函数 (shlobj_core.h)

  • 项目

[此函数可通过 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 获得。 在后续版本的 Windows 中，它可能已更改或不可用。]

创建具有可选安全属性的新文件系统文件夹。

语法

int SHCreateDirectoryExW(
  [in, optional] HWND                      hwnd,
  [in]           LPCWSTR                   pszPath,
  [in, optional] const SECURITY_ATTRIBUTES *psa
);

参数

[in, optional] hwnd

类型：HWND

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

[in] pszPath

类型： LPCTSTR

指向以 null 结尾的字符串的指针，该字符串指定目录的完全限定路径。 此字符串的最大长度为 248 个字符，包括终止 null 字符。

[in, optional] psa

类型： const SECURITY_ATTRIBUTES*

指向具有目录安全属性 的SECURITY_ATTRIBUTES 结构的指针。 如果不需要设置安全属性，请将此参数设置为 NULL 。

返回值

类型： int

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

返回代码 说明
ERROR_BAD_PATHNAME
 pszPath 参数已设置为相对路径。
ERROR_FILENAME_EXCED_RANGE
 pszPath 指向的路径太长。
ERROR_PATH_NOT_FOUND
 系统找不到 pszPath 指向的路径。 路径可能包含无效条目。
ERROR_FILE_EXISTS
 目录存在。
ERROR_ALREADY_EXISTS
 目录存在。
ERROR_CANCELLED
 用户取消了操作。

注解

此函数创建一个文件系统文件夹，其完全限定路径由 pszPath 提供。 如果一个或多个中间文件夹不存在，则也会创建它们。 SHCreateDirectoryEx 还会验证文件是否可见。 如果它们不可见，需要以下其中一项：

  • 如果 hwnd 设置为有效的窗口句柄，则会显示一个消息框，警告用户他/她可能无法访问文件。 如果用户选择不继续，函数将返回 ERROR_CANCELLED。
  • 如果 hwnd 设置为 NULL，则不显示用户界面，并且函数返回 ERROR_CANCELLED。

注意

shlobj_core.h 标头将 SHCreateDirectoryEx 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

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

另请参阅

SHCreateDirectory