Функция f_unlink удаляет файл или директорию.

FRESULT f_unlink (
  const TCHAR* FileName  /* Указатель на имя удаляемого объекта */
);

Параметр

FileName

Указатель на null-terminated (заканчивающуюся нулем) строку, которая задает имя удаляемого объекта.

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

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_NO_FILE, FR_NO_PATH, FR_INVALID_NAME, FR_DENIED, FR_EXIST, FR_WRITE_PROTECTED, FR_INVALID_DRIVE, FR_NOT_ENABLED, FR_NO_FILESYSTEM, FR_TIMEOUT, FR_LOCKED, FR_NOT_ENOUGH_CORE

Описание

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

• Объект не должен иметь атрибут только для чтения (read-only attribute AM_RDO), иначе функция не удалит объект и возвратит код FR_DENIED.
• Удаляемая директория должна быть пустой, и не должна быть текущей директорией, иначе функция не удалит объект и возвратит код FR_DENIED.
• Удаляемый файл не должен быть открыт, иначе the том FAT может быть приведен к коллапсу. Это может быть запрещено с для функции f_unlink, и она вернет FR_LOCKED, когда для файла разрешено управление общим доступом (file sharing control).

Краткая информация (QuickInfo)

Функция доступна, когда _FS_READONLY == 0 и _FS_MINIMIZE == 0.