EraseTape 函式 (winbase.h)

EraseTape 函式會清除磁帶的所有或部分。

語法

DWORD EraseTape(
  [in] HANDLE hDevice,
  [in] DWORD  dwEraseType,
  [in] BOOL   bImmediate
);

[in] hDevice

要清除磁帶之裝置的句柄。此句柄是使用 CreateFile 函式所建立。

[in] dwEraseType

清除技術。此參數可以是下列其中一個值。

值	意義
TAPE_ERASE_LONG 1L	清除磁帶從目前位置到目前磁碟分區的結尾。
TAPE_ERASE_SHORT 0L	寫入目前位置的清除間距或數據結尾標記。

[in] bImmediate

如果此參數為 TRUE，函式會立即傳回;如果為 FALSE，則函式在清除作業完成之前不會傳回。

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，它可以傳回下列其中一個錯誤碼。

錯誤碼	描述
ERROR_BEGINNING_OF_MEDIA 1102L	嘗試在中度開始標記失敗之前存取數據。
ERROR_BUS_RESET 1111L	在總線上偵測到重設條件。
ERROR_DEVICE_NOT_PARTITIONED 1107L	載入磁帶時找不到數據分割資訊。
ERROR_END_OF_MEDIA 1100L	作業期間已達到磁帶結束標記。
ERROR_FILEMARK_DETECTED 1101L	作業期間已達到檔案標記。
ERROR_INVALID_BLOCK_LENGTH 1106L	在多卷積分割區的新磁帶上，區塊大小不正確。
ERROR_MEDIA_CHANGED 1110L	磁碟驅動器中的磁帶已取代或移除。
ERROR_NO_DATA_DETECTED 1104L	作業期間已達到數據結束標記。
ERROR_NO_MEDIA_IN_DRIVE 1112L	磁碟驅動器中沒有媒體。
ERROR_NOT_SUPPORTED 50L	磁帶驅動程式不支援要求的函式。
ERROR_PARTITION_FAILURE 1105L	無法分割磁帶。
ERROR_SETMARK_DETECTED 1103L	作業期間已達到 setmark。
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	嘗試鎖定退出機制失敗。
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	嘗試卸除磁帶失敗。
ERROR_WRITE_PROTECT 19L	媒體受到寫入保護。

某些磁帶裝置不支援某些磁帶作業。若要判斷磁帶裝置的功能，請參閱磁帶裝置檔，並使用 GetTapeParameters 函式。