Funzione CancelTape (winbase.h)

Articolo
03/08/2023

La funzione CancelTape cancella tutto o parte di un nastro.

Sintassi

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

Parametri

[in] hDevice

Gestire il dispositivo in cui il nastro deve essere cancellato. Questo handle viene creato usando la funzione CreateFile .

[in] dwEraseType

Tecnica di cancellazione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
TAPE_ERASE_LONG 1L	Cancella il nastro dalla posizione corrente alla fine della partizione corrente.
TAPE_ERASE_SHORT 0L	Scrive un gap di cancellazione o un marcatore end-of-data nella posizione corrente.

[in] bImmediate

Se questo parametro è TRUE, la funzione restituisce immediatamente; se è FALSE, la funzione non restituisce fino al completamento dell'operazione di cancellazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, può restituire uno dei codici di errore seguenti.

Codice di errore	Descrizione
ERROR_BEGINNING_OF_MEDIA 1102L	Tentativo di accesso ai dati prima dell'inizio del marcatore medio non riuscito.
ERROR_BUS_RESET 1111L	È stata rilevata una condizione di reimpostazione sul bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Impossibile trovare le informazioni sulla partizione quando è stato caricato un nastro.
ERROR_END_OF_MEDIA 1100L	Il marcatore finale del nastro è stato raggiunto durante un'operazione.
ERROR_FILEMARK_DETECTED 1101L	Un segno di file è stato raggiunto durante un'operazione.
ERROR_INVALID_BLOCK_LENGTH 1106L	Le dimensioni del blocco non sono corrette su un nuovo nastro in una partizione multivolume.
ERROR_MEDIA_CHANGED 1110L	Il nastro che era nell'unità è stato sostituito o rimosso.
ERROR_NO_DATA_DETECTED 1104L	Il marcatore end-of-data è stato raggiunto durante un'operazione.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Non sono presenti supporti nell'unità.
ERROR_NOT_SUPPORTED 50L	Il driver di nastro non supporta una funzione richiesta.
ERROR_PARTITION_FAILURE 1105L	Impossibile partizionare il nastro.
ERROR_SETMARK_DETECTED 1103L	Un segno di impostazione è stato raggiunto durante un'operazione.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Tentativo di bloccare il meccanismo di espulsione non riuscito.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Tentativo di scaricare il nastro non riuscito.
ERROR_WRITE_PROTECT 19L	Il supporto è protetto da scrittura.

Commenti

Alcuni dispositivi nastro non supportano determinate operazioni su nastro. Per determinare le funzionalità del dispositivo nastro, vedere la documentazione del dispositivo nastro e usare la funzione GetTapeParameters .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

CreateFile

GetTapeParameters

Condividi tramite