Функция CreateDirectoryFromAppW (fileapifromapp.h)

Статья
08/23/2023

Создает каталог. Поведение этой функции идентично функции CreateDirectory, за исключением того, что эта функция соответствует модели безопасности приложений универсальная платформа Windows.

Синтаксис

WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
  LPCWSTR               lpPathName,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;

Параметры

lpPathName

Путь к создаваемому каталогу.

Сведения об отказе от ограничения MAX_PATH без добавления "\?\" см. в разделе "Ограничение максимальной длины пути" статьи Именование файлов, путей и пространств имен .

lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES . Член lpSecurityDescriptor структуры задает дескриптор безопасности для нового каталога. Если lpSecurityAttributes имеет значение NULL, каталог получает дескриптор безопасности по умолчанию. Списки управления доступом в дескрипторе безопасности по умолчанию для каталога наследуются от его родительского каталога.

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

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Возможные ошибки:

Код возврата	Описание
ERROR_ALREADY_EXISTS	Указанный каталог уже существует.
ERROR_PATH_NOT_FOUND	Один или несколько промежуточных каталогов не существуют; Эта функция создает только окончательный каталог в пути.

Требования


Минимальная версия клиента	Windows 10 версии 1803
Верхняя часть	fileapifromapp.h

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