FatFs - f_unlink

f_unlink

ファイルまたはサブディレクトリを削除します。

FRESULT f_unlink (
  const TCHAR* path  /* [IN] オブジェクト名へのポインタ */
);

引数

path: 削除対象のパス名を示すヌル文字'\0'終端の文字列へのポインタを指定します。

戻り値

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

解説

削除対象のオブジェクトが次の条件に当てはまる場合、そのアクセスは拒否され関数は失敗します。

リードオンリー属性(AM_RDO)を持っている場合は、拒否(FR_DENIED)される。
空でないサブディレクトリまたはカレントディレクトリである場合は、拒否(FR_DENIED)される。
開かれているファイルまたはサブディレクトリである場合は、多重アクセス制御が有効なら安全に拒否(FR_LOCKED)されますが、そうでないときは不正な操作となり、FAT構造が破壊される可能性があります。

対応情報

_FS_READONLY == 0で、且つ_FS_MINIMIZE == 0のときに使用可能です。