Функция RemoveDirectory2A (fileapi.h)

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

Чтобы выполнить эту операцию как транзакцию, используйте функцию RemoveDirectoryTransacted .

Синтаксис

BOOL RemoveDirectory2A(
  LPCSTR          lpPathName,
  DIRECTORY_FLAGS DirectoryFlags
);

Параметры

lpPathName

Путь к каталогу, который нужно удалить. Этот путь должен указать пустой каталог, и вызывающий процесс должен иметь доступ к каталогу.

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

DirectoryFlags

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

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

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

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

Замечания

Функция RemoveDirectory2 помечает каталог для удаления при закрытии. Поэтому каталог не удаляется до закрытия последнего дескриптора каталога.

Чтобы рекурсивно удалить файлы в каталоге, используйте функцию SHFileOperation .

RemoveDirectory2 можно использовать для удаления соединения каталогов. Так как целевой каталог и его содержимое останутся доступными через его канонический путь, сам целевой каталог не затрагивается путем удаления соединения, который предназначен для него. По этой причине, если lpPathName ссылается на соединение каталогов, RemoveDirectory2 удаляет указанную ссылку независимо от того, является ли целевой каталог пустым или нет. Дополнительные сведения о соединениях см. в разделе "Жесткие связи" и "Соединения".

Использование удаления POSIX приводит к удалению каталога, пока дескриптор остается открытым. Последующие вызовы CreateDirectory или CreateDirectory2, чтобы открыть каталог сбоем с ERROR_FILE_NOT_FOUND.

Эта функция поддерживается следующими технологиями:

Требования

См. также

CreateDirectory2

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

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

RemoveDirectoryTransacted