Поделиться через

Функция SHCreateDirectory (shlobj_core.h)

  • Статья

[SHCreateDirectory доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Создает папку файловой системы.

Синтаксис

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

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна. Этот параметр может иметь значение NULL , если пользовательский интерфейс не отображается.

[in] pszPath

Тип: PCWSTR

Указатель на строку Юникода, завершающуюся null, которая содержит полный путь к каталогу. Эта строка должна содержать не более 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
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 5.0 или более поздняя)

См. также раздел

SHCreateDirectoryEx