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 。 如果操作失败,可能会返回其他错误代码,包括此处列出的错误代码。 有关未专门列出的值,请参阅 系统错误代码。
返回代码 | 说明 |
---|---|
|
pszPath 参数已设置为相对路径。 |
|
pszPath 指向的路径太长。 |
|
目录存在。 |
|
目录存在。 |
|
用户取消了操作。 |
注解
此函数创建一个文件系统文件夹,其完全限定路径由 pszPath 提供。 如果一个或多个中间文件夹不存在,则会创建它们。
若要在新文件夹上设置安全属性,请使用 SHCreateDirectoryEx。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shlobj_core.h (包括 Shlobj.h) |
Library | Shell32.lib |
DLL | Shell32.dll (5.0 或更高版本) |