Condividi tramite


Metodo IWriteEngine2::CancelWrite (imapi2.h)

Annulla un'operazione di scrittura in corso.

Sintassi

HRESULT CancelWrite();

Valore restituito

I valori seguenti vengono restituiti in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione: i codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
S_IMAPI_WRITE_NOT_IN_PROGRESS
L'operazione 'write' avviata dall'ultima chiamata a IWriteEngine2::WriteSection non è ancora iniziata e non può essere annullata. È consigliabile chiamare IWriteEngine2::CancelWrite fino a quando non viene restituito un codice di esito positivo diverso.

Valore: 0x00AA0302L

 

I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito Descrizione
E_FAIL
Errore non specificato.

Valore: 0x80004005

Commenti

Per annullare l'operazione di scrittura, è necessario chiamare questo metodo dal gestore eventi DWriteEngine2Events::Update implementato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione imapi2.h

Vedi anche

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::WriteSection

IWriteEngine2::get_WriteInProgress