Méthode IDiscRecorder ::Erase (imapi.h)
Tente d’effacer le média CD-RW s’il s’agit d’un enregistreur de disque CD-RW. Les effacements complets et rapides sont pris en charge.
Syntaxe
HRESULT Erase(
[in] boolean bFullErase
);
Paramètres
[in] bFullErase
Indique le type d’effacement. Si ce paramètre a la valeur FALSE, une suppression rapide est effectuée. Si ce paramètre a la valeur TRUE, une suppression complète est effectuée.
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
Remarques
L’effacement d’un disque peut être une opération très longue (parfois au-delà d’une heure). Pour recevoir une notification de fin d’effacement, utilisez IDiscMasterProgressEvents ::NotifyEraseComplete.
L’option rapide efface uniquement le PMA, la première toc de session et l’espace antérieur à la première piste. Cela efface rapidement un disque (entre 1 et 2 minutes en fonction de la vitesse de l’enregistreur), mais la zone du programme contient toujours des données utilisateur. En revanche, une effacement complet efface l’intégralité du disque.
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 | imapi.h |
| Bibliothèque | Uuid.lib |
| DLL | Actxprxy.dll |