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

#### 解説

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

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

#### 対応情報

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

戻る