Freigeben über

GetTapeStatus-Funktion (winbase.h)

  • Artikel

Die GetTapeStatus-Funktion bestimmt, ob das Bandgerät bereit ist, Bandbefehle zu verarbeiten.

Syntax

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

Parameter

[in] hDevice

Handle an das Gerät, für das das Gerät status. Dieses Handle wird mithilfe der CreateFile-Funktion erstellt.

Rückgabewert

Wenn das Bandgerät bereit ist, geeignete Bandzugriffsbefehle ohne Fehler zu akzeptieren, ist 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 Anfang des mittleren Markers auf Daten zuzugreifen, ist fehlgeschlagen.
ERROR_BUS_RESET
1111L
 Im Bus wurde eine Zurücksetzungsbedingung erkannt.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 Die Partitionsinformationen konnten nicht gefunden werden, wenn ein Band geladen wurde.
ERROR_DEVICE_REQUIRES_CLEANING
1165L
 Das Bandlaufwerk kann melden, dass es eine Reinigung erfordert, und meldet, dass es eine Reinigung erfordert.
ERROR_END_OF_MEDIA
1100L
 Der Bandendemarker wurde während eines Vorgangs erreicht.
ERROR_FILEMARK_DETECTED
1101L
 Während eines Vorgangs wurde ein Filemark 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 auf dem Laufwerk befand, wurde ersetzt oder entfernt.
ERROR_NO_DATA_DETECTED
1104L
 Der Datenendemarker 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.

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 (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CreateFile