##### Shinobi Library - ペリフェラル・記録デバイス関数

# buSetFileAttr

ファイルの属性変更

### 書式

> `Sint32 buSetFileAttr( drive, fname, header, copyflag )
> Sint32 drive
> const char *fname
> Uint16 header
> Uint8 copyflag
> `

### 引数

> drive | 拡張ソケットの番号
> fname | ファイル名
> header | ヘッダオフセット(無視されます)
> copyflag | コピーフラグ(00H〜FFH)

### 戻り値

> BUD_ERR_OK | 処理要求を受け付けた
> BUD_ERR_BUSY | 処理中のため要求を受け付けられなかった

### 解説

> 指定した拡張ソケットに挿入されているメモリーカードの指定したファイルの属性を変更します。

> 拡張ソケットの番号driveには次の値が指定できます。

> 定義 | 意味
> BUD_DRIVE_A1 | ポートAの拡張ソケット1
> BUD_DRIVE_A2 | ポートAの拡張ソケット2
> BUD_DRIVE_B1 | ポートBの拡張ソケット1
> BUD_DRIVE_B2 | ポートBの拡張ソケット2
> BUD_DRIVE_C1 | ポートCの拡張ソケット1
> BUD_DRIVE_C2 | ポートCの拡張ソケット2
> BUD_DRIVE_D1 | ポートDの拡張ソケット1
> BUD_DRIVE_D2 | ポートDの拡張ソケット2

> コピーフラグcopyflagはFFHでコピー不可になります。

### 用例

>     /* Set "copying prohibited" flag (set copy flag to "FFH") */
>     buSetFileAttr(BUD_DRIVE_A1, "SAVEFILE_001", 0, 0xff);
>     if (ret != BUD_ERR_OK) return NG;
>     while (1) {
>     	if (buStat(BUD_DRIVE_A1) == BUD_STAT_READY) break;
>     }
>     if (buGetLastError(BUD_DRIVE_A1) != BUD_ERR_OK)
>     	return NG;
>     return OK;

### 備考

> すでにあるファイルのコピーフラグを変更する場合に使用してください。 ヘッダオフセットは無視されます。0を指定してください。

buSetFileAttr

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000