## 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`のときに使用可能です。

戻る