IWriteEngine2::CancelWrite 方法 (imapi2.h)

取消進行中的寫入作業。

Syntax

HRESULT CancelWrite();

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
S_IMAPI_WRITE_NOT_IN_PROGRESS
上次呼叫 IWriteEngine2::WriteSection 所起始的 'write' 作業尚未開始,而且無法取消。 建議您呼叫 IWriteEngine2::CancelWrite ,直到傳回不同的成功碼為止。

值:0x00AA0302L

 

下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
E_FAIL
未指定的失敗。

值:0x80004005

備註

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

規格需求

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

另請參閱

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::WriteSection

IWriteEngine2::get_WriteInProgress