Fonction EraseTape (winbase.h)

Article
03/06/2024

La fonction EraseTape efface tout ou partie d’une bande.

Syntaxe

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

Paramètres

[in] hDevice

Gérez vers l’appareil où la bande doit être effacée. Ce handle est créé à l’aide de la fonction CreateFile .

[in] dwEraseType

Technique d’effacement. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
TAPE_ERASE_LONG 1L	Efface la bande de la position actuelle jusqu’à la fin de la partition active.
TAPE_ERASE_SHORT 0L	Écrit un intervalle d’effacement ou un marqueur de fin de données à la position actuelle.

[in] bImmediate

Si ce paramètre a la valeur TRUE, la fonction retourne immédiatement ; si elle est FALSE, la fonction ne retourne pas tant que l’opération d’effacement n’est pas terminée.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, elle peut retourner l’un des codes d’erreur suivants.

Code d'erreur	Description
ERROR_BEGINNING_OF_MEDIA 1102L	Tentative d’accès aux données avant l’échec du marqueur de début du moyen.
ERROR_BUS_RESET 1111L	Une condition de réinitialisation a été détectée sur le bus.
ERROR_DEVICE_NOT_PARTITIONED 1107L	Les informations de partition sont introuvables lors du chargement d’une bande.
ERROR_END_OF_MEDIA 1100L	Le marqueur de fin de bande a été atteint lors d’une opération.
ERROR_FILEMARK_DETECTED 1101L	Une marque de fichier a été atteinte lors d’une opération.
ERROR_INVALID_BLOCK_LENGTH 1106L	La taille du bloc est incorrecte sur une nouvelle bande dans une partition multivolume.
ERROR_MEDIA_CHANGED 1110L	La bande qui se trouvait dans le lecteur a été remplacée ou supprimée.
ERROR_NO_DATA_DETECTED 1104L	Le marqueur de fin de données a été atteint pendant une opération.
ERROR_NO_MEDIA_IN_DRIVE 1112L	Il n’y a aucun média dans le lecteur.
ERROR_NOT_SUPPORTED 50L	Le pilote de bande ne prend pas en charge une fonction demandée.
ERROR_PARTITION_FAILURE 1105L	Impossible de partitionner la bande.
ERROR_SETMARK_DETECTED 1103L	Un setmark a été atteint pendant une opération.
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	Une tentative de verrouillage du mécanisme d’éjection a échoué.
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	Une tentative de déchargement de la bande a échoué.
ERROR_WRITE_PROTECT 19L	Le support est protégé en écriture.

Remarques

Certains périphériques à bande ne prennent pas en charge certaines opérations sur bande. Pour déterminer les fonctionnalités de votre périphérique à bande, consultez la documentation de votre périphérique à bande et utilisez la fonction GetTapeParameters .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateFile

GetTapeParameters

Partager via