## 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`または`FR_LOCKED`)され関数は失敗します。

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

#### 対応情報

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

戻る