# FatFs - f_chmod

## f_chmod

ファイルまたはディレクトリの属性を変更します。

    FRESULT f_chmod (
      const TCHAR* path, /* [IN] ファイルまたはディレクトリ名へのポインタ */
      BYTE attr,         /* [IN] 設定値 */
      BYTE mask          /* [IN] 変更マスク */
    );

#### 引数

path
  属性変更対象のファイルまたはディレクトリパス名を示すヌル文字`'\0'`終端の文字列を指定します。
attr
  設定する属性。指定可能な属性は次の通りで、これらの組み合わせで指定します。指定されなかった属性は解除されます。

  値 | 意味
  --- | ---
  AM_RDO | リード・オンリー
  AM_ARC | アーカイブ
  AM_SYS | システム
  AM_HID | ヒドゥン

mask
  変更する属性のマスク。指定した属性が設定または解除され、指定されなかった属性は状態が保持されます。`attr`と同じ値を使います。

#### 戻り値

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

#### 解説

ファイルまたはディレクトリの属性を変更します。

#### 対応情報

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

#### 使用例

        /* リードオンリーをセット、アーカイブをクリア、その他は変更しない */
        f_chmod("file.txt", AM_RDO, AM_RDO | AM_ARC);

戻る