IDiscFormat2Data::CancelWrite-Methode (imapi2.h)
Bricht den aktuellen Schreibvorgang ab.
Syntax
HRESULT CancelWrite();
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Derzeit wird kein Schreibvorgang ausgeführt.
Wert: 0xC0AA0401 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
Hinweise
Um den Schreibvorgang abzubrechen, müssen Sie diese Methode aus dem von Ihnen implementierten DDiscFormat2DataEvents::Update-Ereignishandler aufrufen.
Beachten Sie, dass beim Aufrufen dieser Methode der Schreibvorgang auf allen Medien aufgrund medienspezifischer Anforderungen nicht sofort abgebrochen wird. Beim Schreiben auf eine CD kann der Schreibvorgang beispielsweise noch bis zu drei Minuten fortgesetzt werden.
Diese Methode belässt die Medien in einem unbestimmten Zustand. Für rewritebare Medien sollten Sie die IDiscFormat2Erase::EraseMedia-Methode aufrufen, nachdem Sie diese Methode aufgerufen haben, um die Medien für die zukünftige Verwendung vorzubereiten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |