IDiscFormat2Data::CancelWrite 方法 (imapi2.h)
取消目前的寫入作業。
Syntax
HRESULT CancelWrite();
傳回值
S_OK會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
傳回碼 | Description |
---|---|
|
目前沒有任何寫入作業正在進行中。
值:0xC0AA0401 |
|
未指定的失敗。
值:0x80004005 |
備註
若要取消寫入作業,您必須從您實作的 DDiscFormat2DataEvents::Update 事件處理程式呼叫這個方法。
請注意,由於媒體特定需求,呼叫這個方法並不會立即取消所有媒體上的寫入作業。 例如,寫入CD時,寫入作業最多可以繼續三分鐘。
這個方法會讓媒體處於不確定狀態。 針對可重寫的媒體,您應該在呼叫此方法之後呼叫 IDiscFormat2Erase::EraseMedia 方法,以準備媒體以供日後使用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | imapi2.h |