Freigeben über


IWriteEngine2::CancelWrite-Methode (imapi2.h)

Bricht einen laufenden Schreibvorgang ab.

Syntax

HRESULT CancelWrite();

Rückgabewert

Die folgenden Werte werden bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden: Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
S_IMAPI_WRITE_NOT_IN_PROGRESS
Der durch den letzten Aufruf von IWriteEngine2::WriteSection initiierte Schreibvorgang wurde noch nicht gestartet und kann nicht abgebrochen werden. Es wird empfohlen, IWriteEngine2::CancelWrite aufzurufen, bis ein anderer Erfolgscode zurückgegeben wird.

Wert: 0x00AA0302L

 

Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_FAIL
Unspezifizierter Fehler.

Wert: 0x80004005

Hinweise

Um den Schreibvorgang abzubrechen, müssen Sie diese Methode aus dem DWriteEngine2Events::Update-Ereignishandler aufrufen, den Sie implementiert haben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2.h

Weitere Informationen

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::WriteSection

IWriteEngine2::get_WriteInProgress