Compartir a través de

Función EraseTape (winbase.h)

  • Artículo

La función EraseTape borra toda o parte de una cinta.

Sintaxis

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

Parámetros

[in] hDevice

Controle el dispositivo donde se va a borrar la cinta. Este identificador se crea mediante la función CreateFile .

[in] dwEraseType

Técnica de borrado. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
TAPE_ERASE_LONG
1 L
 Borra la cinta de la posición actual hasta el final de la partición actual.
TAPE_ERASE_SHORT
0L
 Escribe un marcador de intervalo de borrado o de fin de datos en la posición actual.

[in] bImmediate

Si este parámetro es TRUE, la función devuelve inmediatamente; si es FALSE, la función no devuelve hasta que se haya completado la operación de borrado.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, puede devolver uno de los siguientes códigos de error.

Código de error Descripción
ERROR_BEGINNING_OF_MEDIA
1102L
 Error al intentar acceder a los datos antes del marcador inicial de medio.
ERROR_BUS_RESET
1111L
 Se detectó una condición de restablecimiento en el bus.
ERROR_DEVICE_NOT_PARTITIONED
1107L
 No se encontró la información de partición cuando se cargaba una cinta.
ERROR_END_OF_MEDIA
1100L
 El marcador de fin de cinta se alcanzó durante una operación.
ERROR_FILEMARK_DETECTED
1101L
 Se alcanzó una marca de archivo durante una operación.
ERROR_INVALID_BLOCK_LENGTH
1106L
 El tamaño del bloque es incorrecto en una nueva cinta en una partición multivolumen.
ERROR_MEDIA_CHANGED
1110L
 La cinta que estaba en la unidad se ha reemplazado o quitado.
ERROR_NO_DATA_DETECTED
1104L
 Se alcanzó el marcador de fin de datos durante una operación.
ERROR_NO_MEDIA_IN_DRIVE
1112L
 No hay ningún medio en la unidad.
ERROR_NOT_SUPPORTED
50L
 El controlador de cinta no admite una función solicitada.
ERROR_PARTITION_FAILURE
1105L
 No se pudo crear particiones en la cinta.
ERROR_SETMARK_DETECTED
1103L
 Se alcanzó una marca de establecimiento durante una operación.
ERROR_UNABLE_TO_LOCK_MEDIA
1108L
 Error al intentar bloquear el mecanismo de expulsión.
ERROR_UNABLE_TO_UNLOAD_MEDIA
1109L
 Error al intentar descargar la cinta.
ERROR_WRITE_PROTECT
19L
 El medio está protegido contra escritura.

Comentarios

Algunos dispositivos de cinta no admiten ciertas operaciones de cinta. Para determinar las funcionalidades del dispositivo de cinta, consulte la documentación del dispositivo de cinta y use la función GetTapeParameters .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CreateFile

GetTapeParameters