Partager via


Méthode IWriteEngine2 ::CancelWrite (imapi2.h)

Annule une opération d’écriture en cours.

Syntaxe

HRESULT CancelWrite();

Valeur de retour

Les valeurs suivantes sont retournées en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation : Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
S_OK
S_OK
S_IMAPI_WRITE_NOT_IN_PROGRESS
L’opération « write » lancée par le dernier appel à IWriteEngine2 ::WriteSection n’a pas encore commencé et ne peut pas être annulée. Il est recommandé d’appeler IWriteEngine2 ::CancelWrite jusqu’à ce qu’un autre code de réussite soit retourné.

Valeur : 0x00AA0302L

 

Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
E_FAIL
Défaillance non spécifiée.

Valeur : 0x80004005

Remarques

Pour annuler l’opération d’écriture, vous devez appeler cette méthode à partir du gestionnaire d’événements DWriteEngine2Events ::Update que vous avez implémenté.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête imapi2.h

Voir aussi

DWriteEngine2Events

IWriteEngine2

IWriteEngine2 ::WriteSection

IWriteEngine2 ::get_WriteInProgress