EraseTape-Funktion (winbase.h)

Artikel
03/03/2024

Die EraseTape-Funktion löscht ein Band ganz oder teilweise.

Syntax

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

Parameter

[in] hDevice

Handle mit dem Gerät, auf dem das Band gelöscht werden soll. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

[in] dwEraseType

Löschtechnik. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
TAPE_ERASE_LONG 1 L	Löscht das Band von der aktuellen Position bis zum Ende der aktuellen Partition.
TAPE_ERASE_SHORT 0L	Schreibt einen Löschlücken- oder Datenendemarker an der aktuellen Position.

[in] bImmediate

Wenn dieser Parameter TRUE ist, gibt die Funktion sofort zurück. wenn es FALSE ist, wird die Funktion erst zurückgegeben, wenn der Löschvorgang abgeschlossen wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, kann sie einen der folgenden Fehlercodes zurückgeben.

Fehlercode	BESCHREIBUNG
ERROR_BEGINNING_OF_MEDIA 1102L	Ein Versuch, vor dem Beginn der mittleren Markierung auf Daten zuzugreifen, ist fehlgeschlagen.
ERROR_BUS_RESET 1111L	Auf dem Bus wurde eine Zurücksetzungsbedingung erkannt.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Die Partitionsinformationen konnten beim Laden eines Bandes nicht gefunden werden.
ERROR_END_OF_MEDIA 1100L	Der Bandendemarker wurde während eines Vorgangs erreicht.
ERROR_FILEMARK_DETECTED 1101L	Während eines Vorgangs wurde ein Dateizeichen erreicht.
ERROR_INVALID_BLOCK_LENGTH 1106L	Die Blockgröße ist auf einem neuen Band in einer mehrvolumen Partition falsch.
ERROR_MEDIA_CHANGED 1110L	Das Band, das sich im Laufwerk befand, wurde ersetzt oder entfernt.
ERROR_NO_DATA_DETECTED 1104L	Die Datenendemarkierung wurde während eines Vorgangs erreicht.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Das Laufwerk enthält keine Medien.
ERROR_NOT_SUPPORTED 50L	Der Bandtreiber unterstützt keine angeforderte Funktion.
ERROR_PARTITION_FAILURE 1105L	Das Band konnte nicht partitioniert werden.
ERROR_SETMARK_DETECTED 1103L	Während eines Vorgangs wurde ein Setmark erreicht.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Fehler beim Versuch, den Auswurfmechanismus zu sperren.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Fehler beim Entladen des Bandes.
ERROR_WRITE_PROTECT 19L	Das Medium ist schreibgeschützt.

Hinweise

Einige Bandgeräte unterstützen bestimmte Bandvorgänge nicht. Um die Funktionen Ihres Bandgeräts zu ermitteln, lesen Sie die Dokumentation zu Ihrem Bandgerät, und verwenden Sie die GetTapeParameters-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CreateFile

GetTapeParameters

Freigeben über