共用方式為


IDiscFormat2RawCD::CancelWrite 方法 (imapi2.h)

取消目前的寫入作業。

Syntax

HRESULT CancelWrite();

傳回值

成功時會傳回S_OK,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
E_IMAPI_DF2RAW_WRITE_NOT_IN_PROGRESS
目前沒有任何寫入作業正在進行中。

值:0xC0AA0601

E_FAIL
未指定的失敗。

值:0x80004005

備註

若要取消寫入作業,您必須從您實作的 DDiscFormat2RawCDEvents::Update 事件處理程式呼叫此方法。

您也必須在呼叫此方法之後呼叫 IDiscFormat2RawCD::ReleaseMedia 方法。

請注意,由於媒體特定需求,呼叫此方法並不會立即取消所有媒體上的寫入作業。 例如,寫入CD時,寫入作業最多可以繼續三分鐘。

這個方法會讓媒體處於不確定的狀態。 針對可重寫的媒體,您應該在呼叫此方法之後呼叫 IDiscFormat2Erase::EraseMedia 方法,以準備媒體以供日後使用。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 imapi2.h

另請參閱

DDiscFormat2RawCDEvents::Update

IDiscFormat2RawCD