IDiscFormat2TrackAtOnce::CancelAddTrack-Methode (imapi2.h)
Bricht den aktuellen Schreibvorgang ab.
Syntax
HRESULT CancelAddTrack();
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: 0xC0AA0501 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
Hinweise
Um den Schreibvorgang abzubrechen, müssen Sie diese Methode über den von Ihnen implementierten DDiscFormat2TrackAtOnceEvents::Update-Ereignishandler aufrufen.
Sie müssen auch die IDiscFormat2TrackAtOnce::ReleaseMedia-Methode aufrufen, nachdem Sie diese Methode aufgerufen haben.
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 kann dazu führen, dass bereits eine partielle Audiospur aufgezeichnet wurde. Die Methode versucht, die Medien in einem verwendbaren Zustand zu halten, und behandelt einfach den abgebrochenen Track als kürzer als ursprünglich von IStream beschrieben. Aufrufer sollten die Anzahl der Spuren und Spurengrößen nach dem Abbrechen abfragen, um den Datenträgerstatus zu bestimmen.
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 |