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