Метод IDiscFormat2TrackAtOnce::CancelAddTrack (imapi2.h)
Отменяет текущую операцию записи.
Синтаксис
HRESULT CancelAddTrack();
Возвращаемое значение
S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:
| Код возврата | Описание |
|---|---|
|
В настоящее время операция записи не выполняется.
Значение: 0xC0AA0501 |
|
Неуказанным сбоем.
Значение: 0x80004005 |
Комментарии
Чтобы отменить операцию записи, необходимо вызвать этот метод из реализованного обработчика событий DDiscFormat2TrackAtOnceEvents::Update .
После вызова этого метода также необходимо вызвать метод IDiscFormat2TrackAtOnce::ReleaseMedia .
Обратите внимание, что вызов этого метода не приводит к немедленной отмене операции записи на всех носителях из-за требований к конкретному носителю. Например, при записи на компакт-диск операция записи может продолжаться до трех минут.
Этот метод может привести к тому, что частичная звуковая дорожка уже была записана. Метод попытается сохранить носитель в пригодном для использования состоянии и просто будет рассматривать отмененную дорожку как более короткую, чем первоначально было описано В IStream. Вызывающие абоненты должны запросить количество дорожек и их размер после отмены, чтобы определить состояние диска.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imapi2.h |