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

buDeleteFile

ファイルの削除

書式

Sint32 buDeleteFile( drive, fname )
Sint32 drive
const char *fname

引数

drive   拡張ソケットの番号
fname   ファイル名

戻り値

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 


用例

Sint32 ret;
ret = buDeleteFile(BUD_DRIVE_A1, "SAVEDATA");
if (ret == BUD_ERR_OK) {
	/* Delete request was successful */
} else {
	/* Delete request failed (BUSY) */
}

備考

buStat関数によるこの関数の完了ステータスは以下のとおりです。

 ステータス   意味 
 BUD_ERR_OK   正常終了 
 BUD_ERR_NO_DISK   メモリーカードがない 
 BUD_ERR_UNFORMAT   フォーマットされていない 
 BUD_ERR_FILE_NOT_FOUND   ファイルがない 

削除には約 5 Intかかります。 (他のドライブの状態等によっては、多少時間は変動します)


buDeleteFile
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000