IDiscFormat2Data::CancelWrite 方法 (imapi2.h)

取消当前写入操作。

语法

HRESULT CancelWrite();

返回值

成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_IMAPI_DF2DATA_WRITE_NOT_IN_PROGRESS
当前没有正在进行的写入操作。

值:0xC0AA0401

E_FAIL
未知故障。

值:0x80004005

注解

若要取消写入操作,必须从实现的 DDiscFormat2DataEvents::Update 事件处理程序调用此方法。

请注意,由于特定于媒体的要求,调用此方法不会立即取消所有介质上的写入操作。 例如,写入 CD 时,写入操作最多可以再持续三分钟。

此方法使媒体处于不确定状态。 对于可重写媒体,应在调用此方法后调用 IDiscFormat2Erase::EraseMedia 方法,以准备媒体以供将来使用。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

DWriteEngine2Events

IDiscFormat2Data

IDiscFormat2Data::Write