Méthode IDiscFormat2TrackAtOnce ::CancelAddTrack (imapi2.h)
Annule l’opération d’écriture en cours.
Syntaxe
HRESULT CancelAddTrack();
Valeur de retour
S_OK est retourné 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 |
|---|---|
|
Aucune opération d’écriture n’est en cours.
Valeur : 0xC0AA0501 |
|
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 DDiscFormat2TrackAtOnceEvents ::Update que vous avez implémenté.
Vous devez également appeler la méthode IDiscFormat2TrackAtOnce ::ReleaseMedia après avoir appelé cette méthode.
Notez que l’appel de cette méthode n’annule pas immédiatement l’opération d’écriture sur tous les supports en raison des exigences spécifiques au média. Par exemple, lors de l’écriture sur un CD, l’opération d’écriture peut se poursuivre pendant trois minutes supplémentaires.
Cette méthode peut entraîner l’enregistrement d’une piste audio partielle. La méthode tente de maintenir le média dans un état utilisable et traite simplement la piste annulée comme étant plus courte que celle décrite à l’origine par IStream. Les appelants doivent interroger le nombre de pistes et la taille des pistes après l’annulation pour déterminer l’état du disque.
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 |