IDiscRecorder::Erase-Methode (imapi.h)
Versucht, das CD-RW-Medium zu löschen, wenn es sich um einen CD-RW-Datenträgerrecorder handelt. Sowohl vollständige als auch schnelle Löschungen werden unterstützt.
Syntax
HRESULT Erase(
[in] boolean bFullErase
);
Parameter
[in] bFullErase
Gibt den Löschtyp an. Wenn dieser Parameter FALSE ist, wird ein Schnelllöschvorgang ausgeführt. Wenn dieser Parameter TRUE ist, wird eine vollständige Löschung ausgeführt.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
Das Löschen einer Scheibe kann eine sehr lange Operation sein (manchmal mehr als eine Stunde). Um eine Löschvervollständigungsbenachrichtigung zu erhalten, verwenden Sie IDiscMasterProgressEvents::NotifyEraseComplete.
Die Schnelloption löscht nur den PMA, das erste Sitzungs-ToC und die Pre-Gap des ersten Titels. Dadurch wird eine Scheibe schnell gelöscht (je nach Aufzeichnungsgeschwindigkeit zwischen 1 und 2 Minuten), aber der Programmbereich enthält weiterhin Benutzerdaten. Ein vollständiger Löschvorgang hingegen löscht den gesamten Datenträger.
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 | imapi.h |
| Bibliothek | Uuid.lib |
| DLL | Actxprxy.dll |