Fungsi EraseTape (winbase.h)

Artikel
03/03/2024

Fungsi EraseTape menghapus semua atau sebagian pita.

Sintaks

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

Parameter

[in] hDevice

Tangani ke perangkat tempat pita akan dihapus. Handel ini dibuat dengan menggunakan fungsi CreateFile .

[in] dwEraseType

Menghapus teknik. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TAPE_ERASE_LONG 1L	Menghapus pita dari posisi saat ini ke akhir partisi saat ini.
TAPE_ERASE_SHORT 0L	Menulis celah penghapusan atau penanda akhir data pada posisi saat ini.

[in] bImmediate

Jika parameter ini TRUE, fungsi akan segera ditampilkan; jika FALSE, fungsi tidak kembali sampai operasi penghapusan selesai.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, fungsi dapat mengembalikan salah satu kode kesalahan berikut.

Kode kesalahan	Deskripsi
ERROR_BEGINNING_OF_MEDIA 1102L	Upaya untuk mengakses data sebelum penanda awal menengah gagal.
ERROR_BUS_RESET 1111L	Kondisi reset terdeteksi pada bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Informasi partisi tidak dapat ditemukan ketika pita sedang dimuat.
ERROR_END_OF_MEDIA 1100L	Penanda akhir pita tercapai selama operasi.
ERROR_FILEMARK_DETECTED 1101L	Tanda file tercapai selama operasi.
ERROR_INVALID_BLOCK_LENGTH 1106L	Ukuran blok salah pada pita baru dalam partisi multivolume.
ERROR_MEDIA_CHANGED 1110L	Pita yang ada di kandar telah diganti atau dilepas.
ERROR_NO_DATA_DETECTED 1104L	Penanda akhir data tercapai selama operasi.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Tidak ada media di dalam kandar.
ERROR_NOT_SUPPORTED 50L	Driver pita tidak mendukung fungsi yang diminta.
ERROR_PARTITION_FAILURE 1105L	Pita tidak dapat dipartisi.
ERROR_SETMARK_DETECTED 1103L	Tanda set tercapai selama operasi.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Upaya untuk mengunci mekanisme ejeksi gagal.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Upaya untuk membongkar pita gagal.
ERROR_WRITE_PROTECT 19L	Media dilindungi terhadap penulisan.

Keterangan

Beberapa perangkat pita tidak mendukung operasi pita tertentu. Untuk menentukan kemampuan perangkat pita Anda, lihat dokumentasi perangkat pita Anda dan gunakan fungsi GetTapeParameters .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CreateFile

GetTapeParameters

Bagikan melalui