IDiscFormat2TrackAtOnce::CancelAddTrack 方法 (imapi2.h)
取消当前写入操作。
语法
HRESULT CancelAddTrack();
返回值
成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
返回代码 | 说明 |
---|---|
|
当前没有正在进行的写入操作。
值:0xC0AA0501 |
|
未知故障。
值:0x80004005 |
注解
若要取消写入操作,必须从实现的 DDiscFormat2TrackAtOnceEvents::Update 事件处理程序调用此方法。
在调用此方法后,还必须调用 IDiscFormat2TrackAtOnce::ReleaseMedia 方法。
请注意,由于特定于媒体的要求,调用此方法不会立即取消所有介质上的写入操作。 例如,写入 CD 时,写入操作最多可以再持续三分钟。
此方法可能会导致已录制部分音频曲目。 方法将尝试使媒体保持可用状态,并将取消的曲目视为比 IStream 最初描述的要短。 调用方应在取消后查询曲目数和轨道大小,以确定光盘状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | imapi2.h |