Функция CreateDirectoryTransactedA (winbase.h)

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для работы с которыми был разработан TxF, можно реализовать с помощью более простых и доступных методов. Кроме того, TxF может быть недоступен в будущих версиях Microsoft Windows. Дополнительные сведения и альтернативы TxF см. в разделе Альтернативы использованию транзакционной NTFS.]

Создает каталог как транзакцию с атрибутами указанного каталога шаблона. Если базовая файловая система поддерживает безопасность файлов и каталогов, функция применяет указанный дескриптор безопасности к новому каталогу. Новый каталог сохраняет другие атрибуты указанного каталога шаблона.

Синтаксис

BOOL CreateDirectoryTransactedA(
  [in, optional] LPCSTR                lpTemplateDirectory,
  [in]           LPCSTR                lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           HANDLE                hTransaction
);

Параметры

[in, optional] lpTemplateDirectory

Путь к каталогу для использования в качестве шаблона при создании нового каталога. Этот параметр может принимать значение NULL.

По умолчанию имя ограничено MAX_PATH символами. Чтобы расширить это ограничение до 32 767 символов в ширину, добавьте к пути "\\?\". Дополнительные сведения см. в статье Именование файлов, путей и пространств имен.

Каталог должен находиться на локальном компьютере; В противном случае функция завершается сбоем, а для последнего кода ошибки задано значение ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

[in] lpNewDirectory

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

По умолчанию имя ограничено MAX_PATH символами. Чтобы расширить это ограничение до 32 767 символов в ширину, добавьте к пути "\\?\". Дополнительные сведения см. в статье Именование файлов, путей и пространств имен.

[in, optional] lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES . Элемент lpSecurityDescriptor структуры задает дескриптор безопасности для нового каталога.

Если lpSecurityAttributes имеет значение NULL, каталог получает дескриптор безопасности по умолчанию. Списки управления доступом (ACL) в дескрипторе безопасности по умолчанию для каталога наследуются от его родительского каталога.

Чтобы этот параметр действовал, целевая файловая система должна поддерживать безопасность файлов и каталогов. Это указывается, когда GetVolumeInformation возвращает FS_PERSISTENT_ACLS.

[in] hTransaction

Дескриптор транзакции. Этот дескриптор возвращается функцией CreateTransaction .

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

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

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

Комментарии

Функция CreateDirectoryTransacted позволяет создавать каталоги, которые наследуют сведения о потоке от других каталогов. Эта функция полезна, например, при использовании каталогов Macintosh, которые имеют поток ресурсов, необходимый для правильной идентификации содержимого каталога в качестве атрибута.

Некоторые файловые системы, такие как файловая система NTFS, поддерживают сжатие или шифрование для отдельных файлов и каталогов. На томах, отформатированных для такой файловой системы, новый каталог наследует атрибуты сжатия и шифрования родительского каталога.

Эта функция завершается сбоем при ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION при попытке создать дочерний каталог с родительским каталогом, для которого отключено шифрование.

Дескриптор каталога можно получить, вызвав функцию CreateFileTransacted с установленным флагом FILE_FLAG_BACKUP_SEMANTICS .

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

SMB 3.0 не поддерживает TxF.

Требования

См. также

CreateFileTransacted

Создание и удаление каталогов

Функции управления каталогами

RemoveDirectoryTransacted

SECURITY_ATTRIBUTES

Поддержка транзакций в NTFS