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)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

SHCreateDirectoryEx