EraseTape功能会删除磁带的全部或部分。
DWORD EraseTape(lb
HANDLE 【hDevice】, | //打开设备的句柄 |
DWORD 【dwEraseType】, | //执行的擦除类型 |
BOOL 【bImmediate】 | //擦除操作开始后返回 |
); |
参数
【hDevice】
标识要擦除磁带的设备。该句柄是通过使用CreateFile函数创建的。
【dwEraseType】
指定擦除技术。此参数可以是以下值之一:
值 | 描述 |
TAPE_ERASE_LONG | 将磁带从当前位置擦除到当前分区的末尾。 |
TAPE_ERASE_SHORT | 在当前位置写入擦除间隙或数据结尾标记。 |
【bImmediate】
指定擦除操作开始后是否返回。如果此参数为TRUE,则函数立即返回;如果为FALSE,则在擦除操作完成之前,该函数不会返回。
返回值
如果函数成功,返回值为NO_ERROR。
如果函数失败,则返回值为以下错误代码之一:
错误代码 | 描述 |
ERROR_BEGINNING_OF_MEDIA | 在中间标记开始之前访问数据的尝试失败。 |
ERROR_BUS_RESET | 在总线上检测到复位条件。 |
ERROR_END_OF_MEDIA | 在操作期间到达磁带末端标记。 |
ERROR_FILEMARK_DETECTED | 在操作期间达到文件标记。 |
ERROR_SETMARK_DETECTED | 在操作期间达成了一个标记。 |
ERROR_NO_DATA_DETECTED | 在操作期间达到数据结尾标记。 |
ERROR_PARTITION_FAILURE | 磁带无法分区。 |
ERROR_INVALID_BLOCK_LENGTH | 多卷分区中的新磁带上的块大小不正确。 |
ERROR_DEVICE_NOT_PARTITIONED | 加载磁带时无法找到分区信息。 |
ERROR_MEDIA_CHANGED | 驱动器中的磁带已被更换或删除。 |
ERROR_NO_MEDIA_IN_DRIVE | 驱动器中没有媒体。 |
ERROR_NOT_SUPPORTED | 磁带驱动程序不支持所请求的功能。 |
ERROR_UNABLE_TO_LOCK_MEDIA | 试图锁定弹出机构失败。 |
ERROR_UNABLE_TO_UNLOAD_MEDIA | 尝试卸载磁带失败。 |
ERROR_WRITE_PROTECT | 媒体是写保护的。 |
备注
某些磁带设备不支持某些磁带操作。要确定磁带设备的功能,请参阅磁带设备文档并使用GetTapeParameters功能。
也可以看看